Enrich your billing data via API

The Fincome API is not only used to import your invoices and subscriptions: it also lets you enrich your existing data with custom fields. These additional attributes help you contextualize your analyses, segment your KPIs more finely, and bring Fincome closer to your internal business logic.

This approach is particularly useful if:

you want to sync information from an internal tool (e.g. segment, CSM, region, contract type);
or if you are looking to automate the creation and updating of custom attributes without manual intervention;
you want to maintain data consistency between Fincome and your other systems (Data Warehouse, ERP, support tool, etc.).

Thanks to this integration, Fincome becomes a true enriched mirror of your business data: all your custom attributes are injected and updated automatically, then directly usable in your dashboards (MRR, churn, retention, LTV, etc.).

Objects that can be enriched

The Fincome API lets you enrich all the objects of the data model:

Customers (/clients)
Subscriptions (/subscriptions)
Invoices (/invoices)
Invoice lines (/invoice_lines)
Products (/products)
Pricing plans (/plans)
Credits / credit notes (/credit_notes)

Each object can receive custom attributes, which then become usable in your analytical dimensions.

Use cases and perspective

Enriching data via the API is a key step in creating relevant analytical dimensions. These dimensions are then used to filter, break down, and compare your key indicators (MRR, ARR, churn, NRR, etc.) in Fincome.

To learn how to define the dimensions most useful for your business, see the article: Determine the relevant analytical dimensions

Concrete examples of use:

Track MRR or churn by customer segment or acquisition channel.
Analyze retention according to the churn reason.
Break down revenue by pricing plan or region.

Use in Fincome

Once the attributes are added, they become available in the platform's analytical dimensions. You can then filter, break down, or segment your indicators according to these dimensions to refine your analyses.

To learn how to use your dimensions in Fincome, see: Use analytical dimensions in your analyses

Technical documentation

Fincome API | Fincome technical documentationdocs.fincome.co

Updated on: 03/07/2026

Was this article helpful?

Thank you!