Skip to main content

Impots.gouv

You can use Impots.gouv provider to fetch financial information (tax returns, tax return analysis, vat declaration and tax clearance certificate) from your users financial accounts.

This provider supports these data types:

info

This provider is available only for French users

note

impots.gouv also lists the result declarations a company files for less than a month, typically on the day it sells or closes a business during the year. They are kept as partial-period tax returns, returned by GET /tax-returns only with ?include_partial_periods=true.

To retrieve your user financial data, you will have to:

1. Enable Impots.gouv provider:​

PUT /api/v6/providers/impots_gouv
{
"enable": true
}

2. Settings Impots.gouv provider:​

PUT /api/v6/providers/impots_gouv/settings
{
"auto_connect": true
}

3. Create a data connection:​

POST /api/v6/users/{userId}/data-connections
{
"provider_name": "impots_gouv",
"requested_data_types": [
"TAX_RETURN",
"TAX_RETURN_ANALYSIS",
"VAT_DECLARATION",
"CORPORATE_TAX",
"TAX_CLEARANCE_CERTIFICATE",
"TAX_ACCOUNT"
]
}

3. Create a synchronization​

After finishing the connecting process by your user, and after validating that the data connection status is CONNECTED, you can run a new synchronization.

POST /api/v6/users/{userId}/sync
{
"data_types": ["TAX_RETURN", "TAX_RETURN_ANALYSIS", "VAT_DECLARATION", "CORPORATE_TAX", "TAX_CLEARANCE_CERTIFICATE", "TAX_ACCOUNT"]
}

To verify that you are receiving your user's financial data, check out these endpoints:

MethodEndpointDescription
GET/api/v6/users/{userId}/tax-returnsTax returns
GET/api/v6/users/{userId}/tax-returns/{taxReturnId}Single tax return
GET/api/v6/users/{userId}/tax-return-analysisTax return analysis
GET/api/v6/users/{userId}/vat-declarationsVAT declarations
GET/api/v6/users/{userId}/vat-declarations/{vatDeclarationId}Specific VAT declaration
GET/api/v6/users/{userId}/corporate-taxesCorporate taxes
GET/api/v6/users/{userId}/corporate-taxes/{corporateTaxId}Specific corporate tax filing
GET/api/v6/users/{userId}/tax-clearance-certificateTax clearance certificate
GET/api/v6/users/{userId}/tax-accountsTax accounts