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:

• Tax return: to retrieve a list of user tax returns.
• Tax return analysis (Insight): to retrieve a tax return analysis.
• Vat declaration: to retrieve a list of user vat declarations.
• Corporate tax: to retrieve a list of user corporate taxes.
• Tax clearance certificate: to retrieve a tax clearance certificate.
• Tax account: to retrieve a list of user tax accounts.

info

This provider is available only for French users

Link your user Impots.gouv account to Qard API:

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:

Method	Endpoint	Description
GET	/api/v6/users/{userId}/tax-returns	Tax returns
GET	/api/v6/users/{userId}/tax-returns/{taxReturnId}	Single tax return
GET	/api/v6/users/{userId}/tax-return-analysis	Tax return analysis
GET	/api/v6/users/{userId}/vat-declarations	VAT declarations
GET	/api/v6/users/{userId}/vat-declarations/{vatDeclarationId}	Specific VAT declaration
GET	/api/v6/users/{userId}/corporate-taxes	Corporate taxes
GET	/api/v6/users/{userId}/corporate-taxes/{corporateTaxId}	Specific corporate tax filing
GET	/api/v6/users/{userId}/tax-clearance-certificate	Tax clearance certificate
GET	/api/v6/users/{userId}/tax-accounts	Tax accounts