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, more finely segment your KPIs, 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 dimensions most useful to your business, see the article: Defining relevant analytical dimensions
Concrete examples of use:
Track MRR or churn by customer segment or acquisition channel.
Analyze retention according to the reason for churn.
Break down revenues 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: Using analytical dimensions in your analyses
Technical documentation
Last updated