REST API.
Create customers, plans, subscriptions, and events over a typed REST API. Scoped bearer keys, pagination, and regional base URLs.
Lago is an API-first billing platform for usage-based, subscription, and hybrid pricing. Start with the API reference or OpenAPI contract, authenticate with a scoped bearer key, consume signed webhooks, use an official SDK, or connect an AI assistant through Lago's Model Context Protocol server.
Create customers, plans, subscriptions, and events over a typed REST API. Scoped bearer keys, pagination, and regional base URLs.
Receive billing events with delivery retries and idempotency keys. Verify every payload with a JWT or HMAC signature.
Ship with maintained JavaScript, Python, Ruby, Go, PHP, and Kotlin clients generated from the API contract.
Run billing commands, inspect structured results, and diagnose your integration from the terminal.
Connect Claude, ChatGPT, and other MCP clients to Lago billing data and operations through a documented server.
Generate clients, inspect typed operations, or expose billing actions to an AI agent from the OpenAPI 3.1 schema.
Your data is protected with enterprise-grade rigor.
Deploy Lago on-prem, in a VPC or elsewhere.
Role-based access control to set user roles and permissions.
Deploy Lago seamlessly on your own infrastructure to keep full control.
Create a Lago plan from plan.json using the CLI:
lago plans create --input @plan.json --output jsonExample Lago JSON response for a yearly Basic plan with usage-based API charges:
{
"plan": {
"name": "Basic",
"code": "basic",
"interval": "yearly",
"amount_cents": 90000,
"amount_currency": "USD",
"charges": [
{
"billable_metric_code": "api_calls",
"charge_model": "standard"
}
]
}
}