Enrich your billing data via API
Learn how to use the Fincome API to enrich your business data with custom attributes. Add information about your customers, subscriptions or plans to refine your analyses.
The Fincome API is not only used to import your invoices and subscriptions: it also allows you to enrich your existing data with custom fields. These additional attributes help you contextualize your analyses, segment your KPIs more precisely, and align Fincome with your internal business logic.
This approach is particularly useful if:
you want to synchronize 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 wish 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.).
Enrichable objects
The Fincome API allows enriching all objects in 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
Data enrichment via API is a key step to create relevant analytical dimensions. These dimensions are then used to filter, break down and compare your key metrics (MRR, ARR, churn, NRR, etc.) in Fincome.
To learn how to define the most useful dimensions for your business, see the article: Define relevant analytical dimensions
Concrete usage examples:
Track MRR or churn by customer segment or acquisition channel.
Analyze retention according to the reason for churn.
Break down revenue by pricing plan or region.
Usage in Fincome
Once attributes are added, they become available in the platform's analytical dimensions. You can then filter, break down, or segment your metrics 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
Last updated