Advanced Analytica Advanced Analytica: IBOM
← All connectors
Lago logo

Source connector

Lago

Set up Lago as a source and move its data into your chosen destination.

Version 0.7.73 community alpha

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

StreamData synced
billable_metricsBillable metric definitions
plansPricing plans
couponsCoupons
add_onsAdd-ons
invoicesInvoices
customersCustomers
subscriptionsSubscriptions for each customer
walletsPrepaid credit wallets for each customer
customer_usageUsage for each subscription’s current open billing period
feesFees
customer_usage_pastUsage 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_usage contains usage for the current open billing period. Amounts can change while the period remains open.
  • customer_usage_past contains 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

FeatureSupported?(Yes/No)Notes
Full Refresh SyncYes
Incremental SyncNo

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. Use https://api.getlago.com/api/v1 for US Lago Cloud or https://api.eu.getlago.com/api/v1 for 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

  1. Create a source and select Lago.
  2. Enter a name for the source.
  3. 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.
  4. Set API Key to the key you copied from Lago. Enter it without the Bearer prefix. The connector adds the prefix to the authorization header.
  5. 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

VersionDatePull RequestSubject
0.7.732026-11-1090361Simplify error handling configuration for the customer_usage and customer_usage_past streams; no behavior change
0.7.722026-11-1091516Update dependencies
0.7.712026-11-0390549Update dependencies
0.7.702026-10-2789877Update dependencies
0.7.692026-10-2089208Update dependencies
0.7.682026-10-1388601Update dependencies
0.7.672026-10-0687829Update dependencies
0.7.662026-09-2987165Update dependencies
0.7.652026-09-2286604Update dependencies
0.7.642026-09-1586058Update dependencies
0.7.632026-09-0885464Update dependencies
0.7.622026-08-1884595Update dependencies
0.7.612026-08-1183946Update dependencies
0.7.602026-08-0483472Update dependencies
0.7.592026-07-2882929Update dependencies
0.7.582026-07-2182426Update dependencies
0.7.572026-07-1481817Update dependencies
0.7.562026-06-3081060Update dependencies
0.7.552026-06-2380441Update dependencies
0.7.542026-06-1679859Update dependencies
0.7.532026-06-0979333Update dependencies
0.7.522026-06-0278721Update dependencies
0.7.512026-04-2877245Update dependencies
0.7.502026-04-2176585Update dependencies
0.7.492026-03-2475386Update dependencies
0.7.482026-03-1074531Update dependencies
0.7.472026-02-2473758Update dependencies
0.7.462026-02-1773407Update dependencies
0.7.452026-02-1073039Update dependencies
0.7.442026-02-0372575Update dependencies
0.7.432026-01-2071979Update dependencies
0.7.422026-01-1471433Update dependencies
0.7.412025-12-1870668Update dependencies
0.7.402025-11-2569873Update dependencies
0.7.392025-11-1869376Update dependencies
0.7.382025-10-2969052Update dependencies
0.7.372025-10-2168329Update dependencies
0.7.362025-10-1468017Update dependencies
0.7.352025-10-0767267Update dependencies
0.7.342025-09-3066310Update dependencies
0.7.332025-09-0966040Update dependencies
0.7.322025-08-2365373Update dependencies
0.7.312025-08-0964585Update dependencies
0.7.302025-08-0264292Update dependencies
0.7.292025-07-2663857Update dependencies
0.7.282025-07-1963469Update dependencies
0.7.272025-07-1263124Update dependencies
0.7.262025-07-0562644Update dependencies
0.7.252025-06-2862161Update dependencies
0.7.242025-06-2161862Update dependencies
0.7.232025-06-1461226Update dependencies
0.7.222025-05-2460418Update dependencies
0.7.212025-05-1059979Update dependencies
0.7.202025-05-0358861Update dependencies
0.7.192025-04-1958335Update dependencies
0.7.182025-04-1257237Update dependencies
0.7.172025-03-2956550Update dependencies
0.7.162025-03-2255974Update dependencies
0.7.152025-03-0854939Update dependencies
0.7.142025-03-0455179Replace double partition router with extra_fields, fix wallets stream
0.7.132025-02-2254382Update dependencies
0.7.122025-02-1553772Update dependencies
0.7.112025-02-0853370Update dependencies
0.7.102025-02-0152860Update dependencies
0.7.92025-01-2552368Update dependencies
0.7.82025-01-1851667Update dependencies
0.7.72025-01-1151126Update dependencies
0.7.62024-12-2850575Update dependencies
0.7.52024-12-2150044Update dependencies
0.7.42024-12-1449504Update dependencies
0.7.32024-12-1248208Update dependencies
0.7.22024-10-2947730Update dependencies
0.7.12024-10-2847596Update dependencies
0.7.02024-09-1245452Endpoint customer usage: import current from subscription and add new stream customer_usage_past
0.6.02024-09-0645193Endpoint customer usage ignore 405 response
0.5.02024-08-2344613Refactor connector to manifest-only format
0.4.112024-08-1744273Update dependencies
0.4.102024-08-1243800Update dependencies
0.4.92024-08-1043655Update dependencies
0.4.82024-08-0343099Update dependencies
0.4.72024-07-2742727Update dependencies
0.4.62024-07-2041719Update dependencies
0.4.52024-07-1041523Update dependencies
0.4.42024-07-0941133Update dependencies
0.4.32024-07-0640786Update dependencies
0.4.22024-06-2540265Update dependencies
0.4.12024-06-2239979Update dependencies
0.4.02024-06-1335661Add fee stream
0.3.22024-06-0439094[autopull] Upgrade base image to v1.2.1
0.3.12024-05-2138479[autopull] base image + poetry + up_to_date
0.3.02023-10-05#31099Added customer_usage and wallet stream
0.2.02023-09-19#30572Source GetLago: Support API URL
0.1.02022-10-26#18727🎉 New Source: getLago API [low-code CDK]
Advanced Analytica

Most businesses are sitting on information they can’t use at speed. The people who hold it are busy, and when they leave, the knowledge goes with them. The documents are static, and the processes around them weren’t designed for AI.

Advanced Analytica works with these businesses to turn that information into structured data assets. Once they're integrated, AI systems can govern it, and the business can use it. We bring in the strategy, the specification and the AI skills to rework how the business operates.

MOVE FAST. STAY SAFE.