# Read your impots.gouv.fr compte fiscal through an API

> Get the declarations, payments, refund requests and attestation de régularité fiscale in your compte fiscal on impots.gouv.fr with one API call each. A workflow can go through every company you manage each month and email you what was filed, paid or refused.

Page: https://fous.com/automate/impots-gouv-fr-espace-professionnel
Updated: 2026-11-12

Works with your own impots.gouv.fr espace professionnel account. Fous is an independent product.

## What you can build on the espace professionnel

### Get declarations and payments by tax

Reads Consulter mon compte fiscal (consult my tax account) for one company: the declarations filed and payments made for one tax, such as TVA or IS.

- Takes: Company, tax, year
- Returns: Form, period, filing date, amount declared, payment date, amount paid

### Check refund request statuses

Reads the compte fiscal for where each demande de remboursement (refund request) of crédit de TVA or créance d'IS stands.

- Takes: Company, year (optional)
- Returns: Request type, form, filing date, amount requested, status

### Get the attestation de régularité fiscale

Opens Attestation fiscale in Consulter mon compte fiscal and generates the attestation de régularité fiscale, or reads the message shown when it is refused.

- Takes: Company
- Returns: Issued or refused, message shown, date generated, PDF of the attestation

### Send a message to your tax office

Writes a new message in the Messagerie sécurisée (secure messaging) of the espace professionnel to the company's tax office and sends it.

- Takes: Company, subject, message text
- Returns: Subject, date sent

## Automate the espace professionnel with a workflow

A [workflow](/product/workflows) runs your methods as one process, with nobody at the screen. A schedule or a call from your own system starts it, the steps run in order, and the result arrives in your inbox or in the systems you already use.

### Monthly compte fiscal summary for every company you manage

Starts: On the 5th of every month at 8:00

1. For each company you name, get the TVA and IS declarations and payments for the current year.
2. Keep the declarations and payments that were not there on the last run.
3. Email you the list, one section per company.

### Refund requests that changed status

Starts: Every Monday at 9:00

1. For each company, check the status of its crédit de TVA and créance d'IS refund requests.
2. Keep the requests whose status changed since the last run.
3. Post each one, with form, amount requested and status, to your webhook.

### Companies refused an attestation de régularité fiscale

Starts: On the 2nd of every month at 7:00

1. For each company, ask for the attestation de régularité fiscale.
2. Keep the companies where it was refused, with the message shown, and stop when there are none.
3. Email you the list of refused companies and their messages.

You can run a workflow by hand on every plan, Free included. Schedules and webhook triggers come with the paid plans, from $29 a month.

## Once built, one call from your code

Once you have built a [method](/product/methods), it is one POST to /v1/runs from your backend, or a tool an AI agent calls over MCP. This is what “Get declarations and payments by tax” would look like.

Example request:

```
curl https://api.fous.com/v1/runs \
  -H "Authorization: Bearer $FOUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "method": "cfspro.impots.gouv.fr/get_declarations_and_payments",
    "input": {
      "company": "Acme SAS",
      "tax": "TVA",
      "year": 2026
    }
  }'
```

Example response:

```
{
  "status": "completed",
  "data": {
    "company": "Acme SAS",
    "tax": "TVA",
    "declarations": [
      {
        "form": "CA3",
        "period": "2026-09",
        "filed_on": "2026-10-19",
        "amount_declared": 18420
      }
    ],
    "payments": [
      {
        "period": "2026-09",
        "paid_on": "2026-10-19",
        "amount_paid": 18420
      }
    ],
    "currency": "EUR"
  }
}
```

An example with invented data, not a ready-made endpoint. The method exists in your organization once you build it, and its name, inputs and fields follow your request.

## The espace professionnel’s own options

The DGFiP offers two ways to file and pay. EDI sends EDIFACT files for TVA, payments and annual results through an EDI partner: your accountant, a service provider, or your company itself with the technical setup. EFI is filing in the espace professionnel itself, free of charge, where the compte fiscal, attestations, refund tracking and secure messaging also are, and the DGFiP documents no API for them.

| Option | What it covers | What it takes |
| --- | --- | --- |
| EDI (EDI-TVA, EDI-Paiement, EDI-TDFC, EDI-Requête) | Declarations and payments sent as EDIFACT files, with an acceptance or rejection reported back for each file. | An EDI partner (your company, your accountant or a provider) that follows the DGFiP's cahiers des charges and transmits by CFT or FTPS. |
| The espace professionnel by hand | Consulter mon compte fiscal, Déclarer, Payer, the TVA UE services and the Messagerie sécurisée, one company at a time. | A free espace professionnel and the services you joined, such as Consulter mon compte fiscal. |

Read on November 12, 2026: [Qui sont les partenaires EDI et quel est leur rôle ?](https://www.impots.gouv.fr/qui-sont-les-partenaires-edi-et-quel-est-leur-role), [L'offre de services de l'espace professionnel](https://www.impots.gouv.fr/professionnel/loffre-de-services), [Fiche technique téléprocédures des professionnels](https://www.impots.gouv.fr/sites/default/files/media/1_metier/2_professionnel/procedure_en_ligne_professionnels.pdf).

## Signing in to the espace professionnel

The espace professionnel asks for the Adresse électronique (email address) and the Mot de passe (password) you chose when you created it, and important emails go to that address. With Fous you sign in once through the site's own sign-in with your own account: the login is sealed with AES-256, never shown to code or AI agents, and an expired session is signed back in.

## Worth knowing

- **The attestation is not for every company**: It is issued online only to companies liable to IS and TVA, never in the year of creation, and only when filings and payments are up to date. Others send form 3666-SD to their tax office through the secure messaging.
- **Compliance is judged at the end of last month**: The attestation de régularité fiscale reflects your situation on the last day of the month before you ask for it, and can be generated again as often as needed during the year.
- **Pay only after the declaration is validated**: For TVA, IS, taxe sur les salaires and CVAE, a declaration must be validated before it can be paid, and the bank account needs a signed SEPA B2B mandate registered by your bank first.
- **Some filings are EDI only**: The 1330-CVAE declaration and the IS and BIC-RN annual results must go through EDI, so an EDI partner such as your accountant files them, not the espace professionnel.

## More in Government: UK and Western Europe

- [Guichet unique des formalités d'entreprises](https://fous.com/automate/guichet-unique-des-formalites-d-entreprises.md)
- [Companies House WebFiling](https://fous.com/automate/companies-house-webfiling.md)
- [Planning Portal](https://fous.com/automate/planning-portal.md)
- [Chorus Pro](https://fous.com/automate/chorus-pro.md)
- [FCA RegData](https://fous.com/automate/fca-regdata.md)
- [net-entreprises.fr](https://fous.com/automate/net-entreprises-fr.md)
- [Urssaf compte employeur](https://fous.com/automate/urssaf-compte-employeur.md)
- [ePortal ESTV](https://fous.com/automate/eportal-estv.md)
- [FinanzOnline](https://fous.com/automate/finanzonline.md)
- [MOT Testing Service](https://fous.com/automate/mot-testing-service.md)

Other industries: [eFileTexas](/automate/efiletexas), [CommBroker](/automate/commbroker), [SAM.gov](/automate/sam-gov), [MyFloridaMarketPlace Vendor Information Portal](/automate/myfloridamarketplace-vendor-information-portal), [MassTaxConnect](/automate/masstaxconnect), [MiUI Employer Portal](/automate/miui-employer-portal).

## Frequently asked questions

### Does the impots.gouv.fr espace professionnel have an API?

No. The DGFiP documents no API for the compte fiscal, attestations or secure messaging. Machine filing and payment go through EDI: EDIFACT files sent by an EDI partner, which can be your accountant, a service provider or your company itself if it meets the cahiers des charges.

### How do I download an attestation de régularité fiscale?

Open Consulter mon compte fiscal in your espace professionnel and select Attestation fiscale. It works for companies liable to IS and TVA that are up to date, and not in their year of creation. Other companies send form 3666-SD to their tax office through the secure messaging.

### Can I follow my crédit de TVA refund requests online?

Yes. The compte fiscal shows where your refund requests for crédit de TVA and créances d'IS stand. With Fous, a workflow can read them every week for each company and post the ones whose status changed to your webhook.

### Can one account cover several companies?

Yes. An accounting firm can create one espace professionnel in expert mode for several companies and choose the services for each one. A method then takes the company as an input, and a workflow can loop over every company you manage.

### Is Fous affiliated with the Direction générale des Finances publiques (DGFiP)?

No. Fous is an independent product. You use it with your own espace professionnel account, and a method reads and does only what that account can.

Fous is an independent product: it is not affiliated with, endorsed by or sponsored by the operator of impots.gouv.fr espace professionnel (Direction générale des Finances publiques (DGFiP)). The name is used only to say which system this page is about. Something here wrong or out of date? Write to legal@fous.com.
