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 (/v1/import/invoicing/customer)
• Subscriptions (/v1/import/invoicing/subscription)
• Invoices (/v1/import/invoicing/invoice)
• Invoice line items (/v1/import/invoicing/invoice_line_item)
• Products (/v1/import/invoicing/product)
• Prices / pricing plans (/v1/import/invoicing/price)
• Credit notes (/v1/import/invoicing/credit_note) and their lines (/v1/import/invoicing/credit_note_line_item)

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.

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.

Call limits

The API accepts 5 requests per second and 200 requests per minute per account. If you enrich a large number of objects at once, set your script to about 3 requests per second (see Fincome API rate limits (429 error)).

Technical documentation

Fincome API | Fincome technical documentationdocs.fincome.co

Updated on: 25/09/2026