Regions and endpoints
Lago Cloud runs in two regions. Your organization lives in one of them, and API requests must target that region.
SDKs connect to the US region by default. Set the API URL for EU organizations. The CLI takes
--region us or --region eu. See the API reference and developer resources for each SDK.
What Lago runs and what you configure
Usage ingestion
Lago Cloud manages the high-volume pipeline: Kafka or Redpanda for streaming, ClickHouse for storage and aggregation. You send events. Lago’s load tests measure this architecture at 1 to 3 million events per second sustained. See performance and optimization for benchmarks and connector throughput.
Event data is retained for 90 days after a subscription terminates. Contact the Lago team to set up VPC peering or a metering source connector.
Security and compliance
- SOC 2 Type 2 covers the hosted version. Email hello@getlago.com to request the report. See SOC 2.
- Infrastructure runs on AWS with Kubernetes on managed services. Data is encrypted at rest and in transit, with keys managed in AWS KMS. GuardDuty monitors the environment.
- Access control: API keys, SSO, role-based access control, and audit logs. SSO and RBAC are premium add-ons.
- Trust resources: status page, security portal, Cloud terms of service, and privacy.
Features and plans
Lago Cloud includes the open-source billing engine plus Premium features such as invoice previews. Some capabilities, like the AI assistants and certain integrations, are add-ons available on request. Check the pricing page for the current feature list. Choose the guide for your billing workflow:- Enterprise contracts: set a minimum spending commitment, override prices for a customer, and edit a subscription when negotiated terms change.
- Prepaid API or AI usage: create wallets, configure low-balance alerts, and reconcile deductions with wallet traceability. The ongoing wallet balance typically refreshes in under a second after a new event is included in usage.
- Invoicing and finance: generate invoice PDFs, configure taxes, and connect your accounting and CRM tools.
Get started
1
Request an account
Cloud accounts are set up by Lago’s team. Confirm the region, features, and integrations you need.
2
Create an API key
Sign in to the web app for your region and create an API key. Keep it server-side.
3
Model your pricing
Create a billable metric, a plan, and a customer, then assign the plan.
4
Send usage
Ingest events from your application and check them against the subscription.
5
Connect payments
Connect a payment provider to collect invoices.
Cloud or self-hosted
See the deployment FAQ for more detail.