Lago API
Sync overview
This source syncs billing data from the Lago API. It supports full refresh syncs only, so every sync reads all available records again. For large datasets, consider the API requests required to read all data during each sync.
Supported streams
| Stream | Data synced |
|---|---|
billable_metrics | Billable metric definitions |
plans | Pricing plans |
coupons | Coupons |
add_ons | Add-ons |
invoices | Invoices |
customers | Customers |
subscriptions | Subscriptions for each customer |
wallets | Prepaid credit wallets for each customer |
customer_usage | Usage for each subscription’s current open billing period |
fees | Fees |
customer_usage_past | Usage for each subscription’s closed billing periods |
Usage streams
The connector retrieves each customer’s subscriptions, then requests usage for every subscription. You don’t need to enter customer or subscription IDs in the connector configuration.
customer_usagecontains usage for the current open billing period. Amounts can change while the period remains open.customer_usage_pastcontains usage for closed billing periods.
Both usage streams skip a request when Lago returns a 405 response with code no_active_subscription. The request produces no usage records, and the sync continues. The connector doesn’t ignore other 405 errors.
Features
| Feature | Supported?(Yes/No) | Notes |
|---|---|---|
| Full Refresh Sync | Yes | |
| Incremental Sync | No |
Get started
Prerequisites
- A Lago API key for the organisation you want to sync. In Lago, go to Developers > API keys, click Reveal, then copy the key. See Lago’s API key documentation.
- Your Lago API base URL, including
/api/v1. Usehttps://api.getlago.com/api/v1for US Lago Cloud orhttps://api.eu.getlago.com/api/v1for EU Lago Cloud. For self-hosting, use your Lago API URL followed by/api/v1. See Lago’s regions and endpoints.
If your organisation restricts API key permissions, grant read access to the resources you plan to sync. The connection check reads billable_metrics, so the key must list billable metrics. The subscriptions and wallets streams also read customers. Both usage streams read customers and subscriptions.
Set up the source in Airbyte
- Create a source and select Lago.
- Enter a name for the source.
- Set API Url to your Lago API base URL. The default is
https://api.getlago.com/api/v1. Change it for an EU or self-hosted deployment. - Set API Key to the key you copied from Lago. Enter it without the
Bearerprefix. The connector adds the prefix to the authorization header. - Save the source and complete the connection check.
Rate limits and troubleshooting
Lago applies REST API rate limits per organisation and shares them across API keys. Full refresh syncs can consume this shared budget. Requests for customers, subscriptions and usage also count towards it. If 429 Too Many Requests errors persist, reduce competing API traffic or ask Lago to increase your limits.
If you receive 401 Unauthorized, confirm the API key is valid. Also check that the API URL matches your organisation’s region or self-hosted deployment. For 403 Forbidden, check the key’s permissions and your organisation’s access to the requested feature. A successful connection check confirms access to billable_metrics. It doesn’t confirm access to every selected stream.
IP allow list
If you use Airbyte Cloud and restrict access to specific IPs, add the Airbyte Cloud IP addresses to your allow list.
Changelog
| Version | Date | Pull Request | Subject |
|---|---|---|---|
| 0.7.73 | 2026-11-10 | 90361 | Simplify error handling configuration for the customer_usage and customer_usage_past streams; no behavior change |
| 0.7.72 | 2026-11-10 | 91516 | Update dependencies |
| 0.7.71 | 2026-11-03 | 90549 | Update dependencies |
| 0.7.70 | 2026-10-27 | 89877 | Update dependencies |
| 0.7.69 | 2026-10-20 | 89208 | Update dependencies |
| 0.7.68 | 2026-10-13 | 88601 | Update dependencies |
| 0.7.67 | 2026-10-06 | 87829 | Update dependencies |
| 0.7.66 | 2026-09-29 | 87165 | Update dependencies |
| 0.7.65 | 2026-09-22 | 86604 | Update dependencies |
| 0.7.64 | 2026-09-15 | 86058 | Update dependencies |
| 0.7.63 | 2026-09-08 | 85464 | Update dependencies |
| 0.7.62 | 2026-08-18 | 84595 | Update dependencies |
| 0.7.61 | 2026-08-11 | 83946 | Update dependencies |
| 0.7.60 | 2026-08-04 | 83472 | Update dependencies |
| 0.7.59 | 2026-07-28 | 82929 | Update dependencies |
| 0.7.58 | 2026-07-21 | 82426 | Update dependencies |
| 0.7.57 | 2026-07-14 | 81817 | Update dependencies |
| 0.7.56 | 2026-06-30 | 81060 | Update dependencies |
| 0.7.55 | 2026-06-23 | 80441 | Update dependencies |
| 0.7.54 | 2026-06-16 | 79859 | Update dependencies |
| 0.7.53 | 2026-06-09 | 79333 | Update dependencies |
| 0.7.52 | 2026-06-02 | 78721 | Update dependencies |
| 0.7.51 | 2026-04-28 | 77245 | Update dependencies |
| 0.7.50 | 2026-04-21 | 76585 | Update dependencies |
| 0.7.49 | 2026-03-24 | 75386 | Update dependencies |
| 0.7.48 | 2026-03-10 | 74531 | Update dependencies |
| 0.7.47 | 2026-02-24 | 73758 | Update dependencies |
| 0.7.46 | 2026-02-17 | 73407 | Update dependencies |
| 0.7.45 | 2026-02-10 | 73039 | Update dependencies |
| 0.7.44 | 2026-02-03 | 72575 | Update dependencies |
| 0.7.43 | 2026-01-20 | 71979 | Update dependencies |
| 0.7.42 | 2026-01-14 | 71433 | Update dependencies |
| 0.7.41 | 2025-12-18 | 70668 | Update dependencies |
| 0.7.40 | 2025-11-25 | 69873 | Update dependencies |
| 0.7.39 | 2025-11-18 | 69376 | Update dependencies |
| 0.7.38 | 2025-10-29 | 69052 | Update dependencies |
| 0.7.37 | 2025-10-21 | 68329 | Update dependencies |
| 0.7.36 | 2025-10-14 | 68017 | Update dependencies |
| 0.7.35 | 2025-10-07 | 67267 | Update dependencies |
| 0.7.34 | 2025-09-30 | 66310 | Update dependencies |
| 0.7.33 | 2025-09-09 | 66040 | Update dependencies |
| 0.7.32 | 2025-08-23 | 65373 | Update dependencies |
| 0.7.31 | 2025-08-09 | 64585 | Update dependencies |
| 0.7.30 | 2025-08-02 | 64292 | Update dependencies |
| 0.7.29 | 2025-07-26 | 63857 | Update dependencies |
| 0.7.28 | 2025-07-19 | 63469 | Update dependencies |
| 0.7.27 | 2025-07-12 | 63124 | Update dependencies |
| 0.7.26 | 2025-07-05 | 62644 | Update dependencies |
| 0.7.25 | 2025-06-28 | 62161 | Update dependencies |
| 0.7.24 | 2025-06-21 | 61862 | Update dependencies |
| 0.7.23 | 2025-06-14 | 61226 | Update dependencies |
| 0.7.22 | 2025-05-24 | 60418 | Update dependencies |
| 0.7.21 | 2025-05-10 | 59979 | Update dependencies |
| 0.7.20 | 2025-05-03 | 58861 | Update dependencies |
| 0.7.19 | 2025-04-19 | 58335 | Update dependencies |
| 0.7.18 | 2025-04-12 | 57237 | Update dependencies |
| 0.7.17 | 2025-03-29 | 56550 | Update dependencies |
| 0.7.16 | 2025-03-22 | 55974 | Update dependencies |
| 0.7.15 | 2025-03-08 | 54939 | Update dependencies |
| 0.7.14 | 2025-03-04 | 55179 | Replace double partition router with extra_fields, fix wallets stream |
| 0.7.13 | 2025-02-22 | 54382 | Update dependencies |
| 0.7.12 | 2025-02-15 | 53772 | Update dependencies |
| 0.7.11 | 2025-02-08 | 53370 | Update dependencies |
| 0.7.10 | 2025-02-01 | 52860 | Update dependencies |
| 0.7.9 | 2025-01-25 | 52368 | Update dependencies |
| 0.7.8 | 2025-01-18 | 51667 | Update dependencies |
| 0.7.7 | 2025-01-11 | 51126 | Update dependencies |
| 0.7.6 | 2024-12-28 | 50575 | Update dependencies |
| 0.7.5 | 2024-12-21 | 50044 | Update dependencies |
| 0.7.4 | 2024-12-14 | 49504 | Update dependencies |
| 0.7.3 | 2024-12-12 | 48208 | Update dependencies |
| 0.7.2 | 2024-10-29 | 47730 | Update dependencies |
| 0.7.1 | 2024-10-28 | 47596 | Update dependencies |
| 0.7.0 | 2024-09-12 | 45452 | Endpoint customer usage: import current from subscription and add new stream customer_usage_past |
| 0.6.0 | 2024-09-06 | 45193 | Endpoint customer usage ignore 405 response |
| 0.5.0 | 2024-08-23 | 44613 | Refactor connector to manifest-only format |
| 0.4.11 | 2024-08-17 | 44273 | Update dependencies |
| 0.4.10 | 2024-08-12 | 43800 | Update dependencies |
| 0.4.9 | 2024-08-10 | 43655 | Update dependencies |
| 0.4.8 | 2024-08-03 | 43099 | Update dependencies |
| 0.4.7 | 2024-07-27 | 42727 | Update dependencies |
| 0.4.6 | 2024-07-20 | 41719 | Update dependencies |
| 0.4.5 | 2024-07-10 | 41523 | Update dependencies |
| 0.4.4 | 2024-07-09 | 41133 | Update dependencies |
| 0.4.3 | 2024-07-06 | 40786 | Update dependencies |
| 0.4.2 | 2024-06-25 | 40265 | Update dependencies |
| 0.4.1 | 2024-06-22 | 39979 | Update dependencies |
| 0.4.0 | 2024-06-13 | 35661 | Add fee stream |
| 0.3.2 | 2024-06-04 | 39094 | [autopull] Upgrade base image to v1.2.1 |
| 0.3.1 | 2024-05-21 | 38479 | [autopull] base image + poetry + up_to_date |
| 0.3.0 | 2023-10-05 | #31099 | Added customer_usage and wallet stream |
| 0.2.0 | 2023-09-19 | #30572 | Source GetLago: Support API URL |
| 0.1.0 | 2022-10-26 | #18727 | 🎉 New Source: getLago API [low-code CDK] |