# Lago ## Docs - [Welcome](https://docs.getlago.com/welcome.md) - [Welcome to Lago](https://docs.getlago.com/guide/introduction/welcome-to-lago.md): Lago is an open-source software for metering and usage-based billing. It's the best alternative to Chargebee, Recurly or Stripe Billing for companies that need to handle complex billing logic. - [Why billing is a nightmare](https://docs.getlago.com/guide/introduction/why-billing-is-a-nightmare.md) - [Overview](https://docs.getlago.com/guide/lago-self-hosted/overview.md): Deploy Lago seamlessly on your infrastructure, compatible with both free and premium editions. - [Docker](https://docs.getlago.com/guide/lago-self-hosted/docker.md): Docker is the easiest way to get started with the self-hosted version of Lago. - [Compatibility Matrix](https://docs.getlago.com/guide/lago-self-hosted/compatibility-matrix.md): Supported technologies and versions for Lago self-hosted deployments. - [Database maintenance](https://docs.getlago.com/guide/lago-self-hosted/database-maintenance.md): Keeping your Postgres at its best - [Tracking & Analytics](https://docs.getlago.com/guide/lago-self-hosted/tracking-analytics.md) - [Versions update](https://docs.getlago.com/guide/lago-self-hosted/update-instance.md) - [Useful commands](https://docs.getlago.com/guide/lago-self-hosted/commands.md): Useful commands for self-hosted users. - [Lago Cloud](https://docs.getlago.com/guide/lago-cloud.md): Lago Cloud is the fully hosted version of our open-source billing API. - [Create billable metrics](https://docs.getlago.com/guide/billable-metrics/create-billable-metrics.md): Billable metrics define how incoming events are aggregated in order to measure consumption. - [Overview](https://docs.getlago.com/guide/billable-metrics/aggregation-types/overview.md): Aggregation types will define how consumption will be measured. - [COUNT](https://docs.getlago.com/guide/billable-metrics/aggregation-types/count.md) - [UNIQUE COUNT](https://docs.getlago.com/guide/billable-metrics/aggregation-types/count-unique.md) - [LATEST](https://docs.getlago.com/guide/billable-metrics/aggregation-types/latest.md) - [MAX](https://docs.getlago.com/guide/billable-metrics/aggregation-types/max.md) - [SUM](https://docs.getlago.com/guide/billable-metrics/aggregation-types/sum.md) - [WEIGHTED SUM](https://docs.getlago.com/guide/billable-metrics/aggregation-types/weighted-sum.md) - [CUSTOM](https://docs.getlago.com/guide/billable-metrics/aggregation-types/custom-agg.md) - [Aggregation examples](https://docs.getlago.com/guide/billable-metrics/aggregation-types/aggregation-examples.md) - [Recurring vs metered](https://docs.getlago.com/guide/billable-metrics/recurring-vs-metered.md) - [SQL Expressions](https://docs.getlago.com/guide/billable-metrics/sql-expressions.md): For more advanced calculations, you can use SQL custom expressions. These expressions are helpful when the aggregation results for a billable metric require complex calculations. - [Rounding](https://docs.getlago.com/guide/billable-metrics/rounding.md): Lago aggregates your events in real time. You can add rounding rules to the final result. - [Filters and dimensions](https://docs.getlago.com/guide/billable-metrics/filters.md): Slice a single billable metric along one or more attributes (region, model, tier…) and price each slice independently on your plans. - [Delete billable metrics](https://docs.getlago.com/guide/billable-metrics/delete-billable-metrics.md) - [Ingest usage](https://docs.getlago.com/guide/events/ingesting-usage.md): Design, send, and manage usage events that Lago turns into accurate, auditable invoices. - [Performance & Optimization](https://docs.getlago.com/guide/events/usage-performances.md): Lago's event processing architecture, production benchmarks, throughput by connector, and optimization strategies for engineering teams. - [Metering ingestion sources](https://docs.getlago.com/guide/events/metering-source.md): Here is a list of sources you can use to ingest usage data. Some of these sources are capable of handling up to 15,000 events per second with default settings. - [Retrieve usage](https://docs.getlago.com/guide/events/retrieve-usage.md): Monitor ingested events, debug warnings, and retrieve current, projected, or past usage data for your customers. - [Usage alerts](https://docs.getlago.com/guide/alerts/usage-alerts.md): Usage alerts allow you to monitor your subscriptions' usage and billing by firing notifications when certain conditions are met. - [Credits consumption alerts](https://docs.getlago.com/guide/alerts/credits-consumption-alerts.md): Credits consumption alerts allow you to monitor your customers' wallet balances by firing notifications when certain thresholds are crossed. - [Overview](https://docs.getlago.com/guide/plans/overview.md): If Billable metrics are made to measure customer usage, Plans are made to apply prices to this usage. - [Plan model](https://docs.getlago.com/guide/plans/plan-model.md): The plan model defines when and how much a customer is charged. - [Usage based charge](https://docs.getlago.com/guide/plans/charges/usage-based-charges.md): Usage-based charges let you bill customers based on actual consumption. They are tied to billable metrics and calculated from usage events collected during the billing period. - [Fixed charge](https://docs.getlago.com/guide/plans/charges/fixed-charges.md): Fixed charges are recurring fees tied to add-ons. They are billed independently of usage events and applied as a fixed amount on invoices. - [Standard](https://docs.getlago.com/guide/plans/charges/charge-models/standard.md) - [Graduated](https://docs.getlago.com/guide/plans/charges/charge-models/graduated.md) - [Package](https://docs.getlago.com/guide/plans/charges/charge-models/package.md) - [Percentage](https://docs.getlago.com/guide/plans/charges/charge-models/percentage.md) - [Volume](https://docs.getlago.com/guide/plans/charges/charge-models/volume.md) - [Graduated percentage](https://docs.getlago.com/guide/plans/charges/charge-models/graduated-percentage.md) - [Dynamic](https://docs.getlago.com/guide/plans/charges/charge-models/dynamic.md) - [Custom price](https://docs.getlago.com/guide/plans/charges/charge-models/custom-price.md) - [Metered vs Recurring](https://docs.getlago.com/guide/plans/charges/metered-vs-recurring.md): Usage-based charges can be either metered or recurring - [Arrears vs Advance](https://docs.getlago.com/guide/plans/charges/arrears-vs-advance.md): Usage-based charges can be either charged in advance or in arrears - [Prorated vs Full](https://docs.getlago.com/guide/plans/charges/prorated-vs-full.md): Usage-based charges can be either billed fully or prorated based on the number of days used. - [Spending minimums](https://docs.getlago.com/guide/plans/charges/spending-minimum.md) - [Invoiceable vs Uninvoiceable](https://docs.getlago.com/guide/plans/charges/invoiceable-vs-noninvoiceable.md): In-advance charges can be either invoiceable or not. - [Charges with filters](https://docs.getlago.com/guide/plans/charges/charges-with-filters.md): Charge your customers by leveraging a combination of filters specified in the billable metric. - [Group keys](https://docs.getlago.com/guide/plans/charges/grouping.md): Group usage by event properties: either to price each group separately, or to break it down on invoices and usage for visibility only. - [Custom pricing units](https://docs.getlago.com/guide/plans/custom-pricing-units.md): A pricing unit works like a custom currency, allowing you to express charges in something other than fiat (e.g., credits or tokens). - [Commitments](https://docs.getlago.com/guide/plans/commitment.md) - [Progressive billing](https://docs.getlago.com/guide/plans/progressive-billing.md): Progressive billing, also known as threshold billing, automatically triggers an invoice when a customer's cumulative usage reaches predefined thresholds. This method ensures that customers cannot exceed certain usage limits without ensuring payment is received, reducing the risk of unpaid services o… - [Customer management](https://docs.getlago.com/guide/customers/customer-management.md) - [Customer metadata](https://docs.getlago.com/guide/customers/customer-metadata.md) - [Invoice a customer](https://docs.getlago.com/guide/customers/invoice-customer.md) - [The customer portal](https://docs.getlago.com/guide/customers/customer-portal.md) - [Billing entities](https://docs.getlago.com/guide/billing-entities.md): Billing entities allow an organization to manage different billing configurations. - [Assign a plan to a customer](https://docs.getlago.com/guide/subscriptions/assign-plan.md): A subscription is created when a plan is assigned to a customer. You can assign a plan to a customer at any time (i.e. when the customer record is created or later on). - [Activation rules](https://docs.getlago.com/guide/subscriptions/activation-rules.md): Hold a subscription in the incomplete state until its activation rules are satisfied. Activation rules are configured per subscription and will expand over time. - [Upgrades and downgrades](https://docs.getlago.com/guide/subscriptions/upgrades-downgrades.md): Customers have the flexibility to easily upgrade or downgrade their plan at any given moment. - [Edit a subscription](https://docs.getlago.com/guide/subscriptions/edit-subscription.md): You can edit a subscription at any time, whether it's active or pending. - [Terminate a subscription](https://docs.getlago.com/guide/subscriptions/terminate-subscription.md): You can terminate a subscription at any time, whether it's active or pending. - [Coupons](https://docs.getlago.com/guide/coupons.md): Coupons allow you to offer discounts to your customers. When you apply a coupon to a customer, its value will be deducted from their next subscription invoice(s). - [Entitlements](https://docs.getlago.com/guide/entitlements.md): Unify entitlements and billing in one streamlined platform with Lago. - [Emails](https://docs.getlago.com/guide/emails.md): Send automatic emails when issuing an invoice or any billing documents. - [Overview](https://docs.getlago.com/guide/invoicing/overview.md): Lago automatically generates invoices for each customer according to the plan model. - [Overview](https://docs.getlago.com/guide/invoicing/invoicing-settings/overview.md): Define invoice look and feel per entity to match your requirements. - [Invoice numbering](https://docs.getlago.com/guide/invoicing/invoicing-settings/invoice-numbering.md): Define how invoice numbers are generated — per customer or across the billing entity. - [Grace period](https://docs.getlago.com/guide/invoicing/invoicing-settings/grace-period.md): Configure a buffer between invoice generation and finalization to review invoices. - [Net payment term](https://docs.getlago.com/guide/invoicing/invoicing-settings/net-payment-term.md): Number of days a customer has to pay an invoice after it has been finalized - [Empty invoice generation](https://docs.getlago.com/guide/invoicing/invoicing-settings/empty-invoices.md): Configure whether Lago should generate invoices with a total amount of zero. - [Issuing date preferences](https://docs.getlago.com/guide/invoicing/invoicing-settings/issuing_date.md): Control when your subscription invoices are dated. - [Taxes](https://docs.getlago.com/guide/invoicing/invoicing-settings/taxes.md): When generating invoices, you may need to apply VAT or other taxes. By creating tax objects and applying them to billing entities and/or customers, the corresponding invoices will reflect the appropriate tax rates. - [Fees](https://docs.getlago.com/guide/invoicing/fees.md): A fee is a line item in an invoice. - [Draft invoices](https://docs.getlago.com/guide/invoicing/draft-invoices.md): A draft invoice is an invoice that is not yet finalized: no number, no payment, no email, no sync. Lago creates it during the grace period so you can review it, fix usage and fees, then finalize it, or delete it if it should never have existed. - [Download invoices](https://docs.getlago.com/guide/invoicing/download-invoices.md) - [Invoice metadata](https://docs.getlago.com/guide/invoicing/invoice-metadata.md) - [Preview an invoice](https://docs.getlago.com/guide/invoicing/previews.md): With Lago, you can preview invoices even if the customer doesn't exist yet, for pending subscriptions, or for active subscriptions. - [Void invoices](https://docs.getlago.com/guide/invoicing/void.md) - [Create add-ons](https://docs.getlago.com/guide/one-off-invoices/create-add-ons.md): Add-ons let you apply one-time fixed fees to plans or one-off invoices. They are commonly used for setup fees, one-off charges, or customer success fees. - [Issue one-off invoices](https://docs.getlago.com/guide/one-off-invoices/create-one-off-invoices.md): One-off invoices allow you to bill immediately one or several add-ons to a customer. This guide will show you how to create a one-off invoice for a specific customer using the add-ons. - [Overview](https://docs.getlago.com/guide/invoicing/credit-notes/overview.md) - [Credit note metadata](https://docs.getlago.com/guide/invoicing/credit-notes/credit-note-metadata.md) - [Revenue share](https://docs.getlago.com/guide/revenue-share.md): Model your revenue-sharing structure within Lago. - [Overview](https://docs.getlago.com/guide/invoicing/e-invoicing/overview.md): Lago automatically generates e-invoices for your billing entities and customers that comply with local regulations - [E-Invoicing contributions](https://docs.getlago.com/guide/invoicing/e-invoicing/contributions.md): Learn how to contribute new E-Invoicing formats and jurisdictions to Lago - [Payment providers integrations](https://docs.getlago.com/guide/payments/payment-providers.md): Automatically collect payments from Payment Providers by using native integrations or webhook messages. - [Payment methods (Beta)](https://docs.getlago.com/guide/payments/payment-methods.md): Customer’s payment instrument (card, bank account, direct debit mandate, etc.), managed by an external Payment Service Provider (PSP). - [Record manual payments](https://docs.getlago.com/guide/payments/record-manual-payments.md): On top of our native integrations with leading payment providers, you can also record manual payments. - [Payment pre-authorization](https://docs.getlago.com/guide/payments/payment-authorization.md): Learn how to validate payment methods before creating, upgrading, or downgrading customer subscriptions. - [Payment retries](https://docs.getlago.com/guide/payments/payment-retries.md) - [Payment receipts](https://docs.getlago.com/guide/payments/receipts.md): Lago automatically generates payment receipts for each payment processed, whether manual or through payment provider integrations. - [Manual dunning](https://docs.getlago.com/guide/dunning/manual-dunning.md): Dunning refers to the process of communicating with customers to remind them of overdue invoices and attempt to recover the outstanding amounts. - [Automatic dunning](https://docs.getlago.com/guide/dunning/automatic-dunning.md): Automate customer communications to remind them of overdue invoices and recover outstanding balances through targeted dunning campaigns. - [Overview](https://docs.getlago.com/guide/wallet-and-prepaid-credits/overview.md): Since usage-based charges can be calculated at the end of the billing period, you often need to wait to collect payments. With prepaid credits, you can now unlock recurring revenue opportunities for pay-as-you-go pricing models. - [Top-up and void credits](https://docs.getlago.com/guide/wallet-and-prepaid-credits/wallet-top-up-and-void.md): Add and void credits, to the customer's wallet. - [Traceability](https://docs.getlago.com/guide/wallet-and-prepaid-credits/traceability.md): Track how credits flow between inbound and outbound wallet transactions. - [Overview](https://docs.getlago.com/guide/ai-agents/agent-sdk/overview.md): Bill LLM token usage directly from your application. Wrap your provider client, ship events to Lago, no middleware to maintain. - [Billing](https://docs.getlago.com/guide/ai-agents/agent-sdk/billing.md): Bill LLM usage in tokens or in dollars. Which mode to pick, the metric codes to register, and the plan setup that prices each token type correctly. - [OpenAI](https://docs.getlago.com/guide/ai-agents/agent-sdk/openai.md): Bill OpenAI token usage with the Lago Agent SDK. Chat Completions and the Responses API, sync, async, and streaming. - [Anthropic](https://docs.getlago.com/guide/ai-agents/agent-sdk/anthropic.md): Bill Anthropic token usage with the Lago Agent SDK. messages.create and the streaming helper, with the full prompt-caching breakdown. - [AWS Bedrock](https://docs.getlago.com/guide/ai-agents/agent-sdk/bedrock.md): Bill AWS Bedrock token usage with the Lago Agent SDK. Converse and InvokeModel, streaming included, across seven response-shape families. - [Google Gemini](https://docs.getlago.com/guide/ai-agents/agent-sdk/gemini.md): Bill Google Gemini token usage with the Lago Agent SDK. The unified google-genai SDK, with reasoning, audio, and image breakdowns. - [Mistral](https://docs.getlago.com/guide/ai-agents/agent-sdk/mistral.md): Bill Mistral token usage with the Lago Agent SDK. chat.complete and chat.stream, with cache-read tokens when the cache hits. - [Cloudflare AI Gateway](https://docs.getlago.com/guide/ai-agents/agent-sdk/cloudflare.md): Bill LLM usage routed through Cloudflare AI Gateway. Live instrumentation on the wrapped client, or backfill from the gateway's own Logs API. - [Databricks AI Gateway](https://docs.getlago.com/guide/ai-agents/agent-sdk/databricks.md): Bill LLM usage routed through Databricks AI Gateway. Live instrumentation on the wrapped client, or backfill from Databricks' own system tables. - [Reference](https://docs.getlago.com/guide/ai-agents/agent-sdk/reference.md): Every configuration option, the error types, how the SDK behaves under failure, and how to bill a provider it does not wrap. - [The Billing Assistant (Beta)](https://docs.getlago.com/guide/ai-agents/billing-assistant.md): Your AI-powered billing assistant for automating manual and repetitive billing operations. - [The Finance Assistant (Beta)](https://docs.getlago.com/guide/ai-agents/finance-assistant.md): Ask any question about your billing data in plain text and get an aggregated report back, in the app or through the MCP server. - [Lago MCP Server](https://docs.getlago.com/guide/ai-agents/mcp-server.md): Connect Lago live data, models, and billing logic to any AI system, bringing billing context and interactions everywhere. - [Webhooks](https://docs.getlago.com/guide/webhooks.md) - [Reports](https://docs.getlago.com/guide/analytics/reports.md): Lago provides a unified analytics layer for billing, revenue, and product usage data. Finance and operations teams use it to compute, monitor, and reconcile revenue metrics. - [Forecasted usage](https://docs.getlago.com/guide/analytics/forecasted-usage.md) - [Export invoices](https://docs.getlago.com/guide/invoicing/export.md): Lago enables you to filter invoices and export them as a simple or advanced CSV file, tailored to your needs. - [Lago Data Pipeline](https://docs.getlago.com/integrations/data/lago-data-pipeline.md): Sync your Lago data with your data warehouse or cloud storage - [Overview](https://docs.getlago.com/guide/revenue-recognition/overview.md): Turn your billing data into accrual-basis revenue you can report, period by period. - [Methodology](https://docs.getlago.com/guide/revenue-recognition/how-it-works/methodology.md): How Lago decides what revenue to recognize, and when. - [Subscriptions](https://docs.getlago.com/guide/revenue-recognition/how-it-works/subscriptions.md): How Lago recognizes subscription fees, billed in advance or in arrears. - [Usage-based charges](https://docs.getlago.com/guide/revenue-recognition/how-it-works/usage-based-charges.md): How Lago recognizes metered usage as it's consumed. - [Minimum commitments](https://docs.getlago.com/guide/revenue-recognition/how-it-works/minimum-commitments.md): How Lago recognizes minimum commitment and true-up fees. - [Taxes](https://docs.getlago.com/guide/revenue-recognition/how-it-works/taxes.md): Why tax is never part of recognized revenue. - [Payments](https://docs.getlago.com/guide/revenue-recognition/how-it-works/payments.md): Why collecting payment doesn't change recognized revenue. - [Credit notes and adjustments](https://docs.getlago.com/guide/revenue-recognition/how-it-works/credit-notes-and-adjustments.md): How credit notes, voids, and coupons reduce recognized revenue. - [Disputes and failed payments](https://docs.getlago.com/guide/revenue-recognition/how-it-works/disputes-and-failed-payments.md): How Lago handles chargebacks, overdue invoices, and bad debt. - [Wallets and prepaid credits](https://docs.getlago.com/guide/revenue-recognition/how-it-works/wallets-and-prepaid-credits.md): How Lago recognizes revenue from prepaid and granted credits. - [Enable revenue recognition](https://docs.getlago.com/guide/revenue-recognition/get-started/enable.md): Turn on revenue recognition for your account. - [Prepare your billing data](https://docs.getlago.com/guide/revenue-recognition/get-started/prepare-billing-data.md): Get the inputs right so recognized revenue comes out right. - [Review your first reporting period](https://docs.getlago.com/guide/revenue-recognition/get-started/review-first-period.md): Read and reconcile your first month of recognized revenue. - [Export revenue recognition data](https://docs.getlago.com/guide/revenue-recognition/get-started/export.md): Get your recognized and deferred revenue out of Lago for the close. - [Recognized Revenue](https://docs.getlago.com/guide/revenue-recognition/reports/recognized-revenue.md): The revenue you earned in a period, regardless of billing or payment timing. - [Deferred Revenue](https://docs.getlago.com/guide/revenue-recognition/reports/deferred-revenue.md): Revenue you invoiced in advance but haven't earned yet. - [Revenue Waterfall](https://docs.getlago.com/guide/revenue-recognition/reports/revenue-waterfall.md): How each invoice releases into revenue across current and future periods. - [Statements](https://docs.getlago.com/guide/revenue-recognition/reports/statements.md): Balance sheet and income statement views built from your billing activity. - [Journal Entry Details](https://docs.getlago.com/guide/revenue-recognition/reports/journal-entry-details.md): The underlying double-entry lines behind every recognized-revenue figure. - [Full lifecycle example](https://docs.getlago.com/guide/revenue-recognition/examples/full-lifecycle.md): One customer, one reporting period, every moving part. - [Audit logs](https://docs.getlago.com/guide/security/audit-logs.md): The audit logs enable organization admins to efficiently track member activity, providing detailed records of who performed each action, what was done, and when it occurred. - [Security logs](https://docs.getlago.com/guide/security/security-logs.md): Security logs track critical actions related to team management, authentication, API keys, and other security-sensitive operations within your organization. - [API Keys](https://docs.getlago.com/guide/security/api-keys.md) - [RBAC - Role-Based Access Control](https://docs.getlago.com/guide/security/rbac.md): Define user roles & permissions in Lago. - [Single Sign-On (SSO)](https://docs.getlago.com/guide/security/sso.md) - [SOC 2 Type 2](https://docs.getlago.com/guide/security/soc.md): Keeping your data secure. - [Integration testing](https://docs.getlago.com/guide/integration-testing.md): This step-by-step integration guide will help you get started with Lago. - [Lago OpenAPI](https://docs.getlago.com/guide/lago-open-api.md) - [Migration to v1.50.0](https://docs.getlago.com/guide/migration/migration-to-v1.50.0.md) - [Migration to v1.45.0](https://docs.getlago.com/guide/migration/migration-to-v1.45.0.md) - [Migration to v1.44.0](https://docs.getlago.com/guide/migration/migration-to-v1.44.0.md) - [Migration to v1.43.0](https://docs.getlago.com/guide/migration/migration-to-v1.43.0.md) - [Migration to v1.32.0](https://docs.getlago.com/guide/migration/migration-to-v1.32.0.md) - [Migration to v1.31.0](https://docs.getlago.com/guide/migration/migration-to-v1.31.0.md) - [Migration to v1.29.0](https://docs.getlago.com/guide/migration/migration-to-v1.29.0.md) - [Migration to v1.28.1](https://docs.getlago.com/guide/migration/migration-to-v1.28.1.md) - [Migration to v1.25.0](https://docs.getlago.com/guide/migration/migration-to-v1.25.0.md) - [Migration to v1.20.0](https://docs.getlago.com/guide/migration/migration-to-v1.20.0.md) - [Migration to v1.2.0](https://docs.getlago.com/guide/migration/migration-to-v1.2.0.md) - [Introduction](https://docs.getlago.com/api-reference/intro.md): Lago API allows your application to push customer information and metrics (events) from your application to the billing application. - [API standards](https://docs.getlago.com/api-reference/api-standards.md) - [Errors](https://docs.getlago.com/api-reference/errors.md) - [Pagination](https://docs.getlago.com/api-reference/pagination.md) - [Rate limits](https://docs.getlago.com/api-reference/rate-limits.md) - [The add-on object](https://docs.getlago.com/api-reference/add-ons/add-on-object.md): This object represents an add-on, a one-time fee that can be applied on one-off invoices. - [Create an add-on](https://docs.getlago.com/api-reference/add-ons/create.md): This endpoint is used to create an add-on that can be then attached to a one-off invoice. - [Update an add-on](https://docs.getlago.com/api-reference/add-ons/update.md): This endpoint is used to update an existing add-on. - [Delete an add-on](https://docs.getlago.com/api-reference/add-ons/destroy.md): This endpoint is used to delete an existing add-on. - [Retrieve an add-on](https://docs.getlago.com/api-reference/add-ons/get-specific.md): This endpoint is used to retrieve a specific add-on. - [List all add-ons](https://docs.getlago.com/api-reference/add-ons/get-all.md): This endpoint is used to list all existing add-ons. - [The alert object](https://docs.getlago.com/api-reference/alerts/alert-object.md): This object represents an alert to monitor your subscriptions' usage and billing by firing notifications when certain conditions are met. - [Create an alert](https://docs.getlago.com/api-reference/alerts/create.md): This endpoint allows you to create a new alert for a subscription. - [Update an alert](https://docs.getlago.com/api-reference/alerts/update.md): This endpoint allows you to update an existing alert for a subscription. - [Delete an alert](https://docs.getlago.com/api-reference/alerts/delete.md): This endpoint allows you to delete an existing alert for a subscription. - [Retrieve an alert](https://docs.getlago.com/api-reference/alerts/get-specific.md): This endpoint allows you to retrieve a specific alert for a subscription. - [List all alerts](https://docs.getlago.com/api-reference/alerts/get-all.md): This endpoint allows you to retrieve all alerts for a subscription. - [The activity log object](https://docs.getlago.com/api-reference/audit-logs/activity-logs-object.md): This object represents an activity log entry of any actions performed on application resources. - [List all activity logs](https://docs.getlago.com/api-reference/audit-logs/get-all-activity-logs.md): This endpoint retrieves all existing activity logs that represent actions performed on application resources. - [Retrieve an activity log](https://docs.getlago.com/api-reference/audit-logs/get-specific-activity-log.md): This endpoint retrieves an existing activity log that represents an action performed on some resource. The activity log is identified by its unique activity_id. - [The API log object](https://docs.getlago.com/api-reference/audit-logs/api-logs-object.md): This object represents an API log entry of any actions performed through the API endpoints. - [List all API logs](https://docs.getlago.com/api-reference/audit-logs/get-all-api-logs.md): This endpoint retrieves all existing api logs that represent requests performed to Lago's API. - [Retrieve an API log](https://docs.getlago.com/api-reference/audit-logs/get-specific-api-log.md): This endpoint retrieves an existing api log that represents a request made to the API. The api log is identified by its unique request_id. - [The billable metric object](https://docs.getlago.com/api-reference/billable-metrics/object.md): This object represents a billable metric used to define how incoming events are aggregated in order to measure consumption. - [Create a billable metric](https://docs.getlago.com/api-reference/billable-metrics/create.md): This endpoint creates a new billable metric representing a pricing component of your application. - [Update a billable metric](https://docs.getlago.com/api-reference/billable-metrics/update.md): This endpoint updates an existing billable metric representing a pricing component of your application. - [Delete a billable metric](https://docs.getlago.com/api-reference/billable-metrics/destroy.md): This endpoint deletes an existing billable metric representing a pricing component of your application. - [Retrieve a billable metric](https://docs.getlago.com/api-reference/billable-metrics/get-specific.md): This endpoint retrieves an existing billable metric that represents a pricing component of your application. The billable metric is identified by its unique code. - [List all billable metrics](https://docs.getlago.com/api-reference/billable-metrics/get-all.md): This endpoint retrieves all existing billable metrics that represent pricing components of your application. - [The billing entity object](https://docs.getlago.com/api-reference/billing-entities/object.md): This object represents a billing entity used to generate invoices. - [Create a billing entity](https://docs.getlago.com/api-reference/billing-entities/create.md): This endpoint is used to create a new billing entity - [Update a billing entity](https://docs.getlago.com/api-reference/billing-entities/update.md): This endpoint is used to update an existing billing entity - [Retrieve a billing entity](https://docs.getlago.com/api-reference/billing-entities/get-specific.md): This endpoint returns a specific billing entity by its code - [List all billing entities](https://docs.getlago.com/api-reference/billing-entities/get-all.md): This endpoint returns a list of all billing entities in the organization - [The coupon object](https://docs.getlago.com/api-reference/coupons/coupon-object.md): This object represents a coupon used to apply discounts on a customer's next invoices. This coupon can be applied to a customer with overridden values. - [Create a coupon](https://docs.getlago.com/api-reference/coupons/create.md): This endpoint is used to create a coupon that can be then attached to a customer to create a discount. - [Update a coupon](https://docs.getlago.com/api-reference/coupons/update.md): This endpoint is used to update a coupon that can be then attached to a customer to create a discount. - [Delete a coupon](https://docs.getlago.com/api-reference/coupons/destroy.md): This endpoint is used to delete a coupon. - [Retrieve a coupon](https://docs.getlago.com/api-reference/coupons/get-specific.md): This endpoint is used to retrieve a specific coupon. - [List all coupons](https://docs.getlago.com/api-reference/coupons/get-all.md): This endpoint is used to list all existing coupons. - [The applied coupon object](https://docs.getlago.com/api-reference/coupons/applied-coupon-object.md): This object represents a coupon applied to a customer. It can override the initial values of a coupon. - [Apply a coupon](https://docs.getlago.com/api-reference/coupons/apply.md): This endpoint is used to apply a specific coupon to a customer, before or during a subscription. - [Delete an applied coupon](https://docs.getlago.com/api-reference/coupons/destroy-applied-coupon.md): This endpoint is used to delete a specific coupon that has been applied to a customer. - [List all applied coupons](https://docs.getlago.com/api-reference/coupons/get-all-applied.md): This endpoint is used to list all applied coupons. You can filter by coupon status and by customer. - [The credit note object](https://docs.getlago.com/api-reference/credit-notes/credit-note-object.md): This object represents a credit note, used to refund or credit back a customer for a fee or an invoice. - [Estimate a credit note](https://docs.getlago.com/api-reference/credit-notes/estimate.md): This endpoint allows you to retrieve amounts for a new credit note creation. - [Create a credit note](https://docs.getlago.com/api-reference/credit-notes/create.md): This endpoint creates a new credit note. - [Download a credit note](https://docs.getlago.com/api-reference/credit-notes/download.md): This endpoint downloads the PDF of an existing credit note. - [Update a credit note](https://docs.getlago.com/api-reference/credit-notes/update.md): This endpoint updates an existing credit note. - [Void available credit](https://docs.getlago.com/api-reference/credit-notes/void.md): This endpoint voids the available credit linked to a specific credit note. - [Retrieve a credit note](https://docs.getlago.com/api-reference/credit-notes/get-specific.md): This endpoint retrieves an existing credit note. - [List all credit notes](https://docs.getlago.com/api-reference/credit-notes/get-all.md): This endpoint list all existing credit notes. - [Replace all metadata](https://docs.getlago.com/api-reference/credit-notes/metadata/create-metadata-cn.md): This endpoint replaces all existing metadata on a credit note with the provided key-value pairs. Any existing metadata keys not included in the request will be removed. - [Update metadata](https://docs.getlago.com/api-reference/credit-notes/metadata/update-metadata-cn.md): This endpoint merges the provided metadata with existing metadata on the credit note. Existing keys not in the request are preserved. New keys are added, existing keys are updated. - [Delete a metadata](https://docs.getlago.com/api-reference/credit-notes/metadata/delete-a-metadata-cn.md): This endpoint removes a single metadata key from a credit note. - [Delete all metadata](https://docs.getlago.com/api-reference/credit-notes/metadata/delete-all-metadata-cn.md): This endpoint removes all metadata from a credit note. - [The customer usage object](https://docs.getlago.com/api-reference/customer-usage/customer-usage-object.md): This object represents the usage-based charges associated with one of your customers for a defined billing period. It allows you to monitor customer usage throughout the period. - [Retrieve usages](https://docs.getlago.com/api-reference/customer-usage/usages.md): Retrieve usages and apply filters to the usage data. - [Retrieve current usage](https://docs.getlago.com/api-reference/customer-usage/get-current.md): Retrieve real-time customer usage data for the current open billing period. - [Retrieve projected usage](https://docs.getlago.com/api-reference/customer-usage/get-projected.md): Retrieve real-time projected usage data for the current open billing period. - [Retrieve past usage](https://docs.getlago.com/api-reference/customer-usage/get-past.md): Fetch historical customer usage data for closed billing periods. - [The customer object](https://docs.getlago.com/api-reference/customers/object.md): This object represents a customer of your business. It lets you create or update a customer, but also track usage and create invoices for the same customer. - [Create a customer](https://docs.getlago.com/api-reference/customers/create.md): This endpoint creates a new customer. - [Update a customer](https://docs.getlago.com/api-reference/customers/update.md): This endpoint creates a new customer. - [Regenerate checkout URL](https://docs.getlago.com/api-reference/customers/psp-checkout-url.md): This endpoint regenerates the Payment Provider Checkout URL of a Customer. - [Delete a customer](https://docs.getlago.com/api-reference/customers/delete.md): This endpoint deletes an existing customer. - [Retrieve a customer](https://docs.getlago.com/api-reference/customers/get-specific.md): This endpoint retrieves an existing customer. - [List all customers](https://docs.getlago.com/api-reference/customers/get-all.md): This endpoint retrieves all existing customers. - [Retrieve customer portal URL](https://docs.getlago.com/api-reference/customers/customer-portal.md): Retrieves an embeddable link for displaying a customer portal. - [The feature object](https://docs.getlago.com/api-reference/entitlements/features/feature-object.md): This object represents a feature of your business, that can be entitled to a customer through a plan or a subscription. - [Create a feature](https://docs.getlago.com/api-reference/entitlements/features/create-feature.md): This endpoint creates a new feature representing an entitlement component of your application. - [Update a feature](https://docs.getlago.com/api-reference/entitlements/features/update-feature.md): This endpoint updates an existing feature representing an entitlement component of your application. - [Delete a feature](https://docs.getlago.com/api-reference/entitlements/features/delete-feature.md): This endpoint deletes an existing feature representing an entitlement component of your application. Deleting a feature will remove it from all plans and subscriptions. - [Delete a feature privilege](https://docs.getlago.com/api-reference/entitlements/features/delete-privilege.md): Delete privilege from feature. Deleting a privilege removes it from all plans and subscriptions. - [Retrieve a feature](https://docs.getlago.com/api-reference/entitlements/features/get-feature.md): This endpoint retrieves an existing feature that represents an entitlement component of your application. The feature is identified by its unique code. - [List all features](https://docs.getlago.com/api-reference/entitlements/features/get-all-features.md): This endpoint retrieves all existing features that represent entitlement components of your application. - [The plan entitlement object](https://docs.getlago.com/api-reference/entitlements/plan-entitlements/plan-entitlement-object.md): This object represents entitlements belonging to a plan. - [Create plan entitlements](https://docs.getlago.com/api-reference/entitlements/plan-entitlements/create-plan-entitlement.md): This endpoint creates new entitlements by adding features to a plan. Note that all existing entitlements will be deleted and replaced by the ones provided. To add a new entitlement without removing the existing ones, use PATCH. The feature must exist and all privileges must be valid for the feature. - [Update plan entitlements](https://docs.getlago.com/api-reference/entitlements/plan-entitlements/update-plan-entitlement.md): This accepts a list of entitlements to update. If the feature isn't part of the plan yet, it's added with all the privileges from the payload. If the feature is already part of the plan, the privilege and values are updated or added. All privileges must be valid for the feature. All features and pr… - [Delete a plan entitlement](https://docs.getlago.com/api-reference/entitlements/plan-entitlements/delete-plan-entitlement.md): This endpoint deletes an existing entitlement by removing the feature from the plan. - [Delete a plan entitlement privilege](https://docs.getlago.com/api-reference/entitlements/plan-entitlements/delete-plan-entitlement-privilege.md): This endpoint removes a specific privilege and its value from an entitlement. The privilege remains untouched on the original feature. - [Retrieve a plan entitlement](https://docs.getlago.com/api-reference/entitlements/plan-entitlements/get-specific-plan-entitlement.md): This endpoint retrieves a specific entitlement for a plan. - [List plan entitlements](https://docs.getlago.com/api-reference/entitlements/plan-entitlements/get-all-plan-entitlements.md): This endpoint retrieves all entitlements for a specific plan. - [The subscription entitlement object](https://docs.getlago.com/api-reference/entitlements/subscription-entitlements/subscription-entitlement-object.md): This object represents entitlements belonging to a subscription. - [Update subscription entitlements](https://docs.getlago.com/api-reference/entitlements/subscription-entitlements/update-subscription-entitlement.md): This accepts a list of entitlements to update. If the feature isn't part of the subscription yet, it's added with all the privileges from the payload. If the feature is already part of the subscription (via plan or via override), the privilege and values are updated or added. All privileges must be… - [Delete a subscription entitlement](https://docs.getlago.com/api-reference/entitlements/subscription-entitlements/delete-subscription-entitlement.md): This endpoint removes a specific feature entitlement from a subscription. The entitlement remains available from the plan. - [Delete a subscription entitlement privilege](https://docs.getlago.com/api-reference/entitlements/subscription-entitlements/delete-subscription-entitlement-privilege.md): This endpoint removes a specific privilege from a subscription entitlement. The privilege entitlement remains available from the plan. - [List subscription entitlements](https://docs.getlago.com/api-reference/entitlements/subscription-entitlements/get-all-subscription-entitlements.md): This endpoint retrieves all entitlements for a specific subscription, including both plan entitlements and any subscription-specific overrides. - [The event object](https://docs.getlago.com/api-reference/events/event-object.md): Events represents usage measurement sent to lago application that will then be aggregated into invoice line items. - [Send usage event](https://docs.getlago.com/api-reference/events/usage.md): This endpoint is used for transmitting usage measurement events to either a designated customer or a specific subscription. - [Batch usage events](https://docs.getlago.com/api-reference/events/batch.md): This endpoint can be used to send a batch of usage records. Each request may include up to 100 events. - [Estimate an upcoming fee](https://docs.getlago.com/api-reference/events/estimated-fee.md): Estimate the fees that would be created after reception of an event for a billable metric attached to one or multiple pay in advance charges. - [Retrieve an event](https://docs.getlago.com/api-reference/events/get-specific.md): This endpoint is used for retrieving a specific usage measurement event that has been sent to a customer or a subscription. - [List all events](https://docs.getlago.com/api-reference/events/list-events.md): This endpoint is used for retrieving all events. - [The fee object](https://docs.getlago.com/api-reference/fees/fee-object.md): This object represents a line item of an invoice, handling amount, billed units and item description. - [Update a fee](https://docs.getlago.com/api-reference/fees/update-fee.md): This endpoint is used for updating a specific fee that has been issued. - [Delete a fee](https://docs.getlago.com/api-reference/fees/destroy-fee.md): This endpoint is used for deleting a specific fee that has not yet been invoiced - [Retrieve a fee](https://docs.getlago.com/api-reference/fees/retrieve-fee.md): This endpoint is used for retrieving a specific fee that has been issued. - [List all fees](https://docs.getlago.com/api-reference/fees/list-fees.md): This endpoint is used for retrieving all fees that has been issued. - [The invoice object](https://docs.getlago.com/api-reference/invoices/invoice-object.md): This object represents an invoice generated by Lago for a specific customer. This invoice summarizes the fees generated by a subscription, usage-based charges, prepaid credit purchases, or one-off invoices. - [Create a one-off invoice](https://docs.getlago.com/api-reference/invoices/create-oneoff.md): This endpoint is used for issuing a one-off invoice. - [Preview an invoice](https://docs.getlago.com/api-reference/invoices/preview.md): This endpoint is used for generating invoice preview. - [Download an invoice](https://docs.getlago.com/api-reference/invoices/download.md): This endpoint is used for downloading a specific invoice PDF document. - [Void an invoice](https://docs.getlago.com/api-reference/invoices/void.md): This endpoint is used for voiding an invoice. • When no body parameters are provided, the invoice can be voided only if it is in a `finalized` status and its payment status is NOT `succeeded`. • When `generate_credit_note` is provided (optionally with `refund_amount` and/or `credit_amount`), this va… - [Retry an invoice finalization](https://docs.getlago.com/api-reference/invoices/retry_finalization.md): This endpoint is used for retrying to generate a failed invoice. - [Retry an invoice payment](https://docs.getlago.com/api-reference/invoices/retry.md): This endpoint resends an invoice for collection and retry a payment. - [Generate a payment URL](https://docs.getlago.com/api-reference/invoices/payment-url.md): This endpoint generates a checkout link for a specific invoice. - [Refresh an invoice](https://docs.getlago.com/api-reference/invoices/refresh.md): This endpoint is used for refreshing a draft invoice. - [Finalize an invoice](https://docs.getlago.com/api-reference/invoices/finalize.md): This endpoint is used for finalizing a draft invoice. - [Update an invoice](https://docs.getlago.com/api-reference/invoices/update.md): This endpoint is used for updating an existing invoice. - [Retrieve an invoice](https://docs.getlago.com/api-reference/invoices/get-specific.md): This endpoint is used for retrieving a specific invoice that has been issued. - [List all invoices](https://docs.getlago.com/api-reference/invoices/get-all.md): This endpoint is used for retrieving all invoices. - [The organization object](https://docs.getlago.com/api-reference/organizations/organization-object.md): This object represents your organization. You can define all invoicing details and settings within it. - [Update organization (deprecated)](https://docs.getlago.com/api-reference/organizations/update.md): This endpoint is used to update your own organization's settings. - [The payment object](https://docs.getlago.com/api-reference/payments/payment-object.md): This object represents a payment generated by Lago for one or multiple invoices. - [Create a payment](https://docs.getlago.com/api-reference/payments/create.md): This endpoint is used to create a manual payment - [Retrieve a payment](https://docs.getlago.com/api-reference/payments/get-specific.md): This endpoint retrieves a specific payment by its ID. - [List all payments](https://docs.getlago.com/api-reference/payments/get-all.md): This endpoint is used to list all payments - [The payment method object](https://docs.getlago.com/api-reference/payment-methods/payment-method-object.md): This object represents a payment method stored on a customer - [Update a payment method](https://docs.getlago.com/api-reference/payment-methods/update.md): Use the payment method as default when not selected a payment method - [Delete a payment method from a customer](https://docs.getlago.com/api-reference/payment-methods/delete.md): This endpoint deletes a specific payment method for a customer. - [List all payment methods for a customer](https://docs.getlago.com/api-reference/payment-methods/get-all.md): This endpoint retrieves all payment methods of a Customer. - [The payment receipt object](https://docs.getlago.com/api-reference/payment-receipts/payment-receipt-object.md): This object represents a receipt generated by Lago for the payment of one or multiple invoices. - [Retrieve a payment receipt](https://docs.getlago.com/api-reference/payment-receipts/get-specific.md): This endpoint retrieves a specific payment receipt. - [List all payment receipts](https://docs.getlago.com/api-reference/payment-receipts/get-all.md): This endpoint is used to list all existing payment receipts. - [The payment request object](https://docs.getlago.com/api-reference/payment-requests/payment-request-object.md): This object represents payment request of a group of overdue invoices for which a payment intent can be created, to settle the overdue balance. - [Create a payment request](https://docs.getlago.com/api-reference/payment-requests/create.md): This endpoint is used to create a payment request to collect payments of overdue invoices of a given customer - [List all payment requests](https://docs.getlago.com/api-reference/payment-requests/get-all.md): This endpoint is used to list all existing payment requests. - [The plan object](https://docs.getlago.com/api-reference/plans/object.md): This object represents a plan. This plan can then be assigned to a customer. - [Create a plan](https://docs.getlago.com/api-reference/plans/create.md): This endpoint creates a plan with subscription and usage-based charges. It supports flexible billing cadence (in-advance or in-arrears) and allows for both recurring and metered charges. - [Update a plan](https://docs.getlago.com/api-reference/plans/update.md): This endpoint updates a specific plan with subscription and usage-based charges. It supports flexible billing cadence (in-advance or in-arrears) and allows for both recurring and metered charges. - [Delete a plan](https://docs.getlago.com/api-reference/plans/destroy.md): This endpoint deletes a specific plan. Note that this plan could be associated with active subscriptions. - [Retrieve a plan](https://docs.getlago.com/api-reference/plans/get-specific.md): This endpoint retrieves a specific plan. - [List all plans](https://docs.getlago.com/api-reference/plans/get-all-plans.md): This endpoint retrieves all existing plans. - [The charge object](https://docs.getlago.com/api-reference/plans/charges/object.md): This object represents a charge associated with a plan. Charges define the pricing for usage-based billable metrics. - [Create a charge](https://docs.getlago.com/api-reference/plans/charges/create.md): This endpoint creates a new charge for a specific plan. - [Update a charge](https://docs.getlago.com/api-reference/plans/charges/update.md): This endpoint updates a specific charge for a plan. - [Delete a charge](https://docs.getlago.com/api-reference/plans/charges/destroy.md): This endpoint deletes a specific charge from a plan. - [Retrieve a charge](https://docs.getlago.com/api-reference/plans/charges/get-specific.md): This endpoint retrieves a specific charge for a plan. - [List all charges](https://docs.getlago.com/api-reference/plans/charges/get-all.md): This endpoint retrieves all charges for a specific plan. - [The charge filter object](https://docs.getlago.com/api-reference/plans/charges/filters/object.md): This object represents a charge filter. Filters allow differentiated pricing to be applied based on additional event properties. - [Create a charge filter](https://docs.getlago.com/api-reference/plans/charges/filters/create.md): This endpoint creates a new filter for a specific charge. - [Update a charge filter](https://docs.getlago.com/api-reference/plans/charges/filters/update.md): This endpoint updates a specific filter for a charge. - [Delete a charge filter](https://docs.getlago.com/api-reference/plans/charges/filters/destroy.md): This endpoint deletes a specific filter from a charge. - [Retrieve a charge filter](https://docs.getlago.com/api-reference/plans/charges/filters/get-specific.md): This endpoint retrieves a specific filter for a charge. - [List all charge filters](https://docs.getlago.com/api-reference/plans/charges/filters/get-all.md): This endpoint retrieves all filters for a specific charge. - [The fixed charge object](https://docs.getlago.com/api-reference/plans/fixed-charges/object.md): This object represents a fixed charge associated with a plan. Fixed charges are based on add-ons and support standard, graduated, and volume charge models. - [Create a fixed charge](https://docs.getlago.com/api-reference/plans/fixed-charges/create.md): This endpoint creates a new fixed charge for a specific plan. - [Update a fixed charge](https://docs.getlago.com/api-reference/plans/fixed-charges/update.md): This endpoint updates a specific fixed charge for a plan. - [Delete a fixed charge](https://docs.getlago.com/api-reference/plans/fixed-charges/destroy.md): This endpoint deletes a specific fixed charge from a plan. - [Retrieve a fixed charge](https://docs.getlago.com/api-reference/plans/fixed-charges/get-specific.md): This endpoint retrieves a specific fixed charge for a plan. - [List all fixed charges](https://docs.getlago.com/api-reference/plans/fixed-charges/get-all.md): This endpoint retrieves all fixed charges for a specific plan. - [Currencies](https://docs.getlago.com/api-reference/resources/currencies.md): List of accepted currencies (ISO 4217). - [Timezones](https://docs.getlago.com/api-reference/resources/timezones.md): List of accepted timezones (TZ database). - [Document locales](https://docs.getlago.com/api-reference/resources/locales.md) - [The subscription object](https://docs.getlago.com/api-reference/subscriptions/subscription-object.md): This object represents the assignation of plan to one of the customer of your business. - [Create a subscription](https://docs.getlago.com/api-reference/subscriptions/assign-plan.md): This endpoint assigns a plan to a customer, creating or modifying a subscription. Ideal for initial subscriptions or plan changes (upgrades/downgrades). - [Update a subscription](https://docs.getlago.com/api-reference/subscriptions/update.md): This endpoint allows you to update a subscription. - [Terminate a subscription](https://docs.getlago.com/api-reference/subscriptions/terminate.md): This endpoint allows you to terminate a subscription. - [Retrieve a subscription](https://docs.getlago.com/api-reference/subscriptions/get-specific.md): This endpoint retrieves a specific subscription. - [List all subscriptions](https://docs.getlago.com/api-reference/subscriptions/get-all.md): This endpoint retrieves all active subscriptions. - [The lifetime usage object](https://docs.getlago.com/api-reference/subscriptions/lifetime-usage-object.md): This object represents the total lifetime usage of a subscription, particularly useful for progressive billing. - [Update subscription lifetime usage](https://docs.getlago.com/api-reference/subscriptions/update-lifetime-usage.md): This endpoint allows you to update the total lifetime usage of a subscription for migration purposes. - [Retrieve subscription lifetime usage](https://docs.getlago.com/api-reference/subscriptions/get-lifetime-usage.md): This endpoint allows you to retrieve the total lifetime usage of a subscription. - [The charge object](https://docs.getlago.com/api-reference/subscriptions/charges/object.md): This object represents a charge associated with a subscription. Charges define the pricing for usage-based billable metrics. - [Update a charge](https://docs.getlago.com/api-reference/subscriptions/charges/update.md): This endpoint creates or updates a charge override for a specific subscription. If the subscription does not have a plan override yet, one will be created automatically. The charge override allows customizing specific charge properties (invoice_display_name, min_amount_cents, properties, filters, ta… - [Retrieve a charge](https://docs.getlago.com/api-reference/subscriptions/charges/get-specific.md): This endpoint retrieves a specific effective charge for a subscription. If the subscription has a plan override with a charge override, the overridden charge is returned. - [List all charges](https://docs.getlago.com/api-reference/subscriptions/charges/get-all.md): This endpoint retrieves all effective charges for a specific subscription. If the subscription has plan overrides with charge overrides, the overridden charges are returned. - [The charge filter object](https://docs.getlago.com/api-reference/subscriptions/charges/filters/object.md): This object represents a charge filter. Filters allow differentiated pricing to be applied based on additional event properties. - [Create a charge filter](https://docs.getlago.com/api-reference/subscriptions/charges/filters/create.md): This endpoint creates a new filter for a specific charge on a subscription. - [Update a charge filter](https://docs.getlago.com/api-reference/subscriptions/charges/filters/update.md): This endpoint updates a specific filter for a charge on a subscription. - [Delete a charge filter](https://docs.getlago.com/api-reference/subscriptions/charges/filters/destroy.md): This endpoint deletes a specific filter from a charge on a subscription. - [Retrieve a charge filter](https://docs.getlago.com/api-reference/subscriptions/charges/filters/get-specific.md): This endpoint retrieves a specific filter for a charge on a subscription. - [List all charge filters](https://docs.getlago.com/api-reference/subscriptions/charges/filters/get-all.md): This endpoint retrieves all filters for a specific charge on a subscription. - [The fixed charge object](https://docs.getlago.com/api-reference/subscriptions/fixed-charges/object.md): This object represents a fixed charge associated with a subscription. Fixed charges are based on add-ons and support standard, graduated, and volume charge models. - [Update a fixed charge](https://docs.getlago.com/api-reference/subscriptions/fixed-charges/update.md): This endpoint creates or updates a fixed charge override for a subscription, without affecting the original plan fixed charge. When the body contains only `units` (and optionally `apply_units_immediately`), the change is recorded as a per-subscription unit override. When the body also sets `invoice_… - [Retrieve a fixed charge](https://docs.getlago.com/api-reference/subscriptions/fixed-charges/get-specific.md): This endpoint retrieves a specific effective fixed charge for a subscription. The `units` reflect any per-subscription unit override applied to the subscription; when no override exists, the plan-level units are returned. - [List all fixed charges](https://docs.getlago.com/api-reference/subscriptions/fixed-charges/get-all.md): This endpoint retrieves all effective fixed charges for a specific subscription. The `units` of each fixed charge reflect any per-subscription unit override applied to the subscription; when no override exists, the plan-level units are returned. - [The tax object](https://docs.getlago.com/api-reference/taxes/tax-object.md): This object represents a customizable tax rate applicable to either the organization or a specific customer. - [Create a tax rate](https://docs.getlago.com/api-reference/taxes/create.md): This endpoint creates a new tax representing a customizable tax rate applicable to either the organization or a specific customer. - [Update a tax rate](https://docs.getlago.com/api-reference/taxes/update.md): This endpoint updates an existing tax representing a customizable tax rate applicable to either the organization or a specific customer. - [Delete a tax rate](https://docs.getlago.com/api-reference/taxes/destroy.md): This endpoint is used to delete a tax. - [Retrieve a tax rate](https://docs.getlago.com/api-reference/taxes/get-specific.md): This endpoint retrieves an existing tax representing a customizable tax rate applicable to either the organization or a specific customer. The tax is identified by its unique code. - [List all tax rates](https://docs.getlago.com/api-reference/taxes/get-all.md): This endpoint retrieves all existing taxes representing a customizable tax rate applicable to either the organization or a specific customer. - [The wallet object](https://docs.getlago.com/api-reference/wallets/wallet-object.md): This object represents a wallet, holding free or prepaid credits. - [Create a wallet](https://docs.getlago.com/api-reference/wallets/create.md): This endpoint is used to create a wallet with prepaid credits. - [Update a wallet](https://docs.getlago.com/api-reference/wallets/update.md): This endpoint is used to update an existing wallet with prepaid credits. - [Terminate a wallet](https://docs.getlago.com/api-reference/wallets/terminate.md): This endpoint is used to terminate an existing wallet with prepaid credits. - [Retrieve a wallet](https://docs.getlago.com/api-reference/wallets/get-specific.md): This endpoint is used to retrieve an existing wallet with prepaid credits. - [List all wallets](https://docs.getlago.com/api-reference/wallets/get-all.md): This endpoint is used to list all wallets with prepaid credits. - [Create a wallet for a customer](https://docs.getlago.com/api-reference/wallets/create-for-customer.md): This endpoint is used to create a wallet with prepaid credits, scoped to a customer identified by its external ID. - [Update a wallet by code](https://docs.getlago.com/api-reference/wallets/update-by-code.md): This endpoint is used to update an existing wallet, identified by the customer's external ID and the wallet code. - [Terminate a wallet by code](https://docs.getlago.com/api-reference/wallets/terminate-by-code.md): This endpoint is used to terminate an existing wallet, identified by the customer's external ID and the wallet code. - [Retrieve a wallet by code](https://docs.getlago.com/api-reference/wallets/get-specific-by-code.md): This endpoint is used to retrieve a single wallet, identified by the customer's external ID and the wallet code. The code is unique per customer. - [List all wallets for a customer](https://docs.getlago.com/api-reference/wallets/get-all-for-customer.md): This endpoint is used to list all wallets with prepaid credits belonging to a customer, identified by its external ID. - [The wallet transaction object](https://docs.getlago.com/api-reference/wallets/wallet-transaction-object.md): This object represents a wallet transaction. It is used for topping up or voiding prepaid credits. - [Top-up a wallet](https://docs.getlago.com/api-reference/wallets/top-up.md): This endpoint is used to top-up an active wallet. - [Generate a payment URL](https://docs.getlago.com/api-reference/wallets/wallet-transaction-payment-url.md): This endpoint generates a checkout link for a specific wallet transaction. - [Retrieve a transaction](https://docs.getlago.com/api-reference/wallets/get-specific-transaction.md): This endpoint is used to retrieve a specific wallet transactions. - [List all wallet transactions](https://docs.getlago.com/api-reference/wallets/get-all-transactions.md): This endpoint is used to list all wallet transactions. - [List all consumptions for a wallet transaction](https://docs.getlago.com/api-reference/wallets/get-all-consumptions.md): This endpoint is used to list all consumption records for an inbound wallet transaction. It shows how the credits from this inbound transaction were consumed by outbound transactions. Only available for traceable wallets. - [List all fundings for a wallet transaction](https://docs.getlago.com/api-reference/wallets/get-all-fundings.md): This endpoint is used to list all funding records for an outbound wallet transaction. It shows which inbound transactions funded this outbound transaction. Only available for traceable wallets. - [The wallet alert object](https://docs.getlago.com/api-reference/wallets/wallet-alert-object.md): This object represents an alert to monitor your wallets' credits consumption by firing notifications when certain conditions are met. - [Create a wallet alert](https://docs.getlago.com/api-reference/wallets/create-alert.md): This endpoint allows you to create a new alert for a wallet. - [Update a wallet alert](https://docs.getlago.com/api-reference/wallets/update-alert.md): This endpoint allows you to update an existing alert for a wallet. - [Delete a wallet alert](https://docs.getlago.com/api-reference/wallets/delete-alert.md): This endpoint allows you to delete an existing alert for a wallet. - [Retrieve a wallet alert](https://docs.getlago.com/api-reference/wallets/get-specific-alert.md): This endpoint allows you to retrieve a specific alert for a wallet. - [List all wallet alerts](https://docs.getlago.com/api-reference/wallets/get-all-alerts.md): This endpoint allows you to retrieve all alerts for a wallet. - [The webhook endpoint object](https://docs.getlago.com/api-reference/webhook-endpoints/webhook-endpoint-object.md): This object represents the webhook endpoint used for listening to Lago’s events - [Create a webhook endpoint](https://docs.getlago.com/api-reference/webhook-endpoints/create.md): This endpoint is used to create a webhook endpoint. - [Update a webhook endpoint](https://docs.getlago.com/api-reference/webhook-endpoints/update.md): This endpoint is used to update an existing webhook endpoint. - [Delete a webhook endpoint](https://docs.getlago.com/api-reference/webhook-endpoints/destroy.md): This endpoint is used to delete an existing webhook endpoint. - [List all webhook endpoints](https://docs.getlago.com/api-reference/webhook-endpoints/get-all.md): This endpoint is used to list all webhook endpoints. - [Retrieve a webhook endpoint](https://docs.getlago.com/api-reference/webhook-endpoints/get-specific.md): This endpoint is used to retrieve an existing webhook endpoint. - [Format & Signature](https://docs.getlago.com/api-reference/webhooks/format---signature.md): Webhooks are HTTP notifications sent from Lago to your application. - [Messages](https://docs.getlago.com/api-reference/webhooks/messages.md): Below is a list of the event types we currently send. Please note that additional event types may be introduced in the future, so your code should be flexible enough to accommodate new types as they arise. Our objective is to maintain a consistent and predictable event structure, making it easier to… - [Introduction](https://docs.getlago.com/integrations/introduction.md): Find all Lago integrations with third-party tools—whether for payment providers, alerting systems, or data integrations. Note that some integrations are native and actively maintained by Lago, while others are community-developed and come with limited support. - [Payments](https://docs.getlago.com/integrations/payments/stripe/payments.md): Lago's native integration with Stripe allows you to collect payments automatically when new invoices are generated. - [Shared Payment Tokens](https://docs.getlago.com/integrations/payments/stripe/shared-payment-tokens.md): Collect invoice payments for agent-initiated purchases using Stripe's Shared Payment Token. - [GoCardless](https://docs.getlago.com/integrations/payments/gocardless-integration.md): Lago's native integration with GoCardless allows you to collect payments via direct debit. - [Adyen](https://docs.getlago.com/integrations/payments/adyen-integration.md): Lago's native integration with Adyen allows you to collect payments automatically when new invoices are generated. - [Segment](https://docs.getlago.com/integrations/usage/segment.md): Segment is a powerful tool that allows you to track the usage of your customers, providing valuable insights that can help you make data-driven decisions. This data can be sent to Lago, our usage-based billing platform, to automate your billing process and ensure accurate invoicing for your custom… - [Hightouch](https://docs.getlago.com/integrations/usage/hightouch.md): Hightouch is a Data Activation platform that syncs data from sources (database, warehouses, spreadsheet and much more) to business applications and developer tools. This data can be sent to Lago, our usage-based billing platform, to automate your billing process and ensure accurate invoicing for y… - [NetSuite](https://docs.getlago.com/integrations/accounting/netsuite.md): Lago seamlessly integrates with NetSuite, enabling real-time synchronization of billing data with your preferred accounting tool. - [Xero](https://docs.getlago.com/integrations/accounting/xero.md): Lago seamlessly integrates with Xero, enabling real-time synchronization of billing data with your preferred accounting tool. - [Lago EU Taxes](https://docs.getlago.com/integrations/taxes/lago-eu-taxes.md) - [Anrok](https://docs.getlago.com/integrations/taxes/anrok.md): Lago's native integration with Anrok allows you to automatically update your invoices with tax amounts sourced directly from Anrok. This integration ensures compliance with international tax regulations by calculating taxes for US & non-US obligations, like VAT. - [Avalara](https://docs.getlago.com/integrations/taxes/avalara.md): Lago's native integration with Avalara allows you to automatically update your invoices with tax amounts sourced directly from Avalara. This integration ensures compliance with international tax regulations by calculating taxes for US & non-US obligations, like VAT. - [Salesforce CRM](https://docs.getlago.com/integrations/crm/salesforce-crm.md): Lago syncs billing data to Salesforce in real-time. - [Salesforce CPQ](https://docs.getlago.com/integrations/crm/salesforce-cpq.md): Lago syncs billing data to Salesforce in real-time. - [HubSpot](https://docs.getlago.com/integrations/crm/hubspot.md): Lago syncs billing data to HubSpot in real-time. - [AWS Marketplace](https://docs.getlago.com/integrations/marketplaces/aws-marketplace.md): Lago integrates with AWS marketplace through our partner Suger.io - [Azure Marketplace](https://docs.getlago.com/integrations/marketplaces/azure-marketplace.md): Lago integrates with Azure marketplace through our partner Suger.io - [GCP Marketplace](https://docs.getlago.com/integrations/marketplaces/gcp-marketplace.md): Lago integrates with GCP marketplace through our partner Suger.io - [Zapier](https://docs.getlago.com/integrations/alerting/zapier.md) - [N8N](https://docs.getlago.com/integrations/alerting/n8n.md) - [Airbyte (ETL)](https://docs.getlago.com/integrations/data/airbyte.md) - [Polytomic (ETL)](https://docs.getlago.com/integrations/data/polytomic.md) - [Cashfree Payments](https://docs.getlago.com/integrations/payments/cashfree-integration.md): Make your users pay Lago invoices with Cashfree Payments, India's leading payments and API banking company. - [Moneyhash](https://docs.getlago.com/integrations/payments/moneyhash-integration.md): Moneyhash is a leading payment infrastructure software in Africa and the Middle East. - [Oso](https://docs.getlago.com/integrations/entitlements/osohq.md) - [QuickBooks](https://docs.getlago.com/integrations/accounting/quickbooks.md): Sync Lago billing data to QuickBooks Online via n8n. - [Introduction](https://docs.getlago.com/templates/introduction.md): Replicate these popular B2B pricing templates to kickstart your journey with Lago. - [Clone Mistral pricing](https://docs.getlago.com/templates/per-token/mistral.md): Replicate Mistral's per-token pricing model with Lago. - [Clone OpenAI pricing](https://docs.getlago.com/templates/per-token/openai.md): Replicate OpenAI's per-token pricing model with Lago. - [Clone Segment pricing](https://docs.getlago.com/templates/hybrid/segment.md): Replicate Segment's hybrid pricing model with Lago. - [Clone Stripe pricing](https://docs.getlago.com/templates/per-transaction/stripe.md): Replicate Stripe's per-transaction pricing model with Lago. - [Clone Algolia pricing](https://docs.getlago.com/templates/payg/algolia.md): Replicate Algolia's pay-as-you-go pricing model with Lago. - [Clone Google BigQuery pricing](https://docs.getlago.com/templates/payg/bigquery.md): Replicate BigQuery's pay-as-you-go pricing model and offer free upfront credits with Lago. - [Clone Notion pricing](https://docs.getlago.com/templates/per-seat/notion.md): Replicate Notion's per-seat pricing model with Lago. - [About Lago](https://docs.getlago.com/faq/about-lago.md) - [About the software](https://docs.getlago.com/faq/about-software.md) - [Community](https://docs.getlago.com/faq/community.md) - [Deployment](https://docs.getlago.com/faq/deployment.md) - [General](https://docs.getlago.com/faq/general.md) - [Pricing](https://docs.getlago.com/faq/pricing.md) - [Product features](https://docs.getlago.com/faq/product-features.md) - [Product updates](https://docs.getlago.com/changelog/product.md): New updates and improvements to Lago. ## OpenAPI Specs - [openapi](https://swagger.getlago.com/openapi.yaml) ## Optional - [Blog](https://www.getlago.com/blog) - [Community](https://www.getlago.com/slack) - [GitHub](https://github.com/getlago/lago) - [Status](https://status.getlago.com/) - [Knowledge Base](https://knowledge.getlago.com)