# Enrich your billing data via API

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**](/en/conduct-in-depth-analyses/segment-your-data-with-analytical-dimensions/determine-the-relevant-analytical-dimensions.md)

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**](/en/conduct-in-depth-analyses/segment-your-data-with-analytical-dimensions/use-analytical-dimensions-in-your-analyses.md)

## Technical documentation

{% embed url="<https://docs.fincome.co/api>" %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://help.fincome.co/en/guide/connect-and-enrich-your-billing-data-via-the-fincome-api/enrich-your-billing-data-via-api.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.