# Get your douane.gouv.fr declarations through an API

> Get your DELTA IE declarations on douane.gouv.fr through an API: their état (state), duties and taxes, and the déclarations complémentaires due. Each weekday morning, a workflow can email you the ones still sous contrôle (under inspection).

Page: https://fous.com/automate/douane-gouv-fr
Updated: 2026-11-12

Works with your own douane.gouv.fr account. Fous is an independent product.

## What you can build on douane.gouv.fr

### Get your declarations and their état

Runs Rechercher > déclarations (search > declarations) in DELTA IE with the advanced criteria: état, declaration type, dates and bureau (customs office).

- Takes: Date range, état (optional), declaration type (optional), bureau (optional)
- Returns: CRN, MRN, LRN, declaration type, état, bureau de déclaration, date

### Read a declaration's liquidation

Opens one declaration in the DELTA IE consultation screen and reads its cycle and the Liquidation récapitulative totale tab (total duties and taxes).

- Takes: CRN or MRN
- Returns: CRN, MRN, LRN, état, cycle steps with dates, each duty or tax with its amount, total in EUR

### List the déclarations complémentaires due

Reads the DELTA IE home page: the Compteurs (counters) and the table Vos déclarations complémentaires (DC) attendues, with each DC deadline.

- Takes: Nothing
- Returns: Counter values (en attente EDOP, expiration proche, anticipé Brexit, attente Crédit, contingent critique), simplified declaration reference, période de dépôt de DC

### Request the invalidation of a declaration

Files a demande d'invalidation (invalidation request) on one declaration in DELTA IE with the motif, your reference and a comment, and returns the customs reference.

- Takes: CRN, motif, référence opérateur, comment (optional), supporting document type and number (optional)
- Returns: Référence douane de la demande, CRN

## Automate douane.gouv.fr 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.

### Declarations still sous contrôle or crédit en attente

Starts: Every weekday at 8:00, Europe/Paris

1. Get the declarations lodged since yesterday morning with their état.
2. Keep the ones in état sous contrôle or crédit en attente.
3. Email you the list with CRN, LRN, bureau and état.

### Déclarations complémentaires close to their deadline

Starts: Every weekday at 7:00, Europe/Paris

1. Read the DELTA IE counters and the table of awaited déclarations complémentaires.
2. Keep the DC whose période de dépôt ends within 2 days, and stop if there are none.
3. Post each one to your webhook with the simplified declaration's reference, its deadline and the contingent critique counter.

### Liquidation of released declarations, to accounting

Starts: Every weekday at 18:00, Europe/Paris

1. Get today's declarations in état BAE (bon à enlever, release) or libéré.
2. Keep the ones that were not in that état on the last run.
3. For each, read the Liquidation récapitulative totale.
4. Post CRN, LRN, each duty or tax and the total to your accounting webhook.

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 your declarations and their état” 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": "douane.gouv.fr/get_delta_ie_declarations",
    "input": {
      "from": "2026-11-11",
      "to": "2026-11-12",
      "etat": "sous contrôle"
    }
  }'
```

Example response:

```
{
  "status": "completed",
  "data": {
    "declarations": [
      {
        "crn": "26FRA0000478213",
        "mrn": "26FR0000418372K4P1",
        "lrn": "ACME2611110042",
        "declaration_type": "IM",
        "etat": "sous contrôle",
        "bureau_de_declaration": "FR009991",
        "date": "2026-11-11T16:42:00+01:00"
      }
    ],
    "count": 1
  }
}
```

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.

## Douane.gouv.fr’s own options

French customs offers an API only as EDI for declarants, under contract. DELTA IE, DELTA H7, Gamma2 and ANTES take JSON messages over an API after a contrat d'utilisation and an API account per téléservice. DELTA G and DELTA X go through certified EDI software. Without that, you use DELTA IE on douane.gouv.fr by hand.

| Option | What it covers | What it takes |
| --- | --- | --- |
| EDI via API (DELTA IE, DELTA H7, Gamma2, ANTES) | Sending declarations and receiving their messages as JSON, asynchronously, over HTTPS with OAuth 2.0. | A contrat d'utilisation per téléservice, requested by email with your SIRET and software, then an API account. Certificates from ANSSI-validated authorities. |
| EDI MAREVA (DELTA G, DELTA X, EMCS-Gamma, ICS) | Declarations exchanged through EDI software certified for each online service. | Certified software from a listed prestataire EDI and a contrat de connexion signed once with the Centre informatique douanier. |
| DELTA IE on douane.gouv.fr by hand (DTI) | Declaring, searching and consulting declarations. Tables export to CSV, and each declaration to PDF, JSON or XML. | A douane.gouv.fr account. Open 24 hours a day, 7 days a week. |

Read on November 12, 2026: [Échange de données informatisé, EDI API](https://www.douane.gouv.fr/fiche/echange-de-donnees-informatise-edi-api), [Échange de données informatisé, EDI MAREVA](https://www.douane.gouv.fr/fiche/echange-de-donnees-informatise-edi-mareva), [Manuel DELTA IE pour les déclarants DTI](https://www.douane.gouv.fr/sites/default/files/2025-06/05/Pas-%C3%A0-pas%20DTI%202025%2005%2005.pdf).

## Signing in to douane.gouv.fr

DELTA IE needs a douane.gouv.fr account. Customs is turning on two-step sign-in for every account: a 6-digit code sent to the account's email address at each sign-in. With Fous you sign in once through douane.gouv.fr's own sign-in with your own account: the login is sealed with AES-256, the emailed code is handled, and an expired session is signed back in.

## Worth knowing

- **Everything starts from your DECO relation**: A DELTA IE declaration starts with Identification, a list of the relations DECO attached to your account. Choosing one fills the bureau de déclaration, and nothing else can be filled before it.
- **Déclarations complémentaires run on a clock**: A simplified declaration waits for its DC within the period set by your authorisation. Expiration proche counts it 2 days before the deadline, and contingent critique means filing the DC the same day or the next.
- **Anticipated declarations expire**: An anticipated declaration shows in expiration proche 6 days before its deadline, and the system deletes it once the délai d'anticipation is over. Annulation and modification requests exist only for anticipated declarations.
- **LRN: your own number, 22 characters**: The LRN is a unique reference you choose: letters and digits only, at most 22 characters. A draft saves itself to your account once the LRN and EORI are filled in.

## More in Logistics: forwarders, air cargo and customs

- [Extensiv 3PL Warehouse Manager](https://fous.com/automate/extensiv-3pl-warehouse-manager.md)
- [Air France KLM Martinair Cargo myCargo](https://fous.com/automate/air-france-klm-martinair-cargo-mycargo.md)
- [e-SkyCargo](https://fous.com/automate/e-skycargo.md)
- [Lufthansa Cargo eServices](https://fous.com/automate/lufthansa-cargo-eservices.md)
- [ACE Secure Data Portal](https://fous.com/automate/ace-secure-data-portal.md)
- [CARM Client Portal](https://fous.com/automate/carm-client-portal.md)
- [Dubai Trade](https://fous.com/automate/dubai-trade.md)
- [Customs Declaration Service](https://fous.com/automate/customs-declaration-service.md)
- [ACE AESDirect](https://fous.com/automate/ace-aesdirect.md)
- [myDHLi](https://fous.com/automate/mydhli.md)
- [myDSV](https://fous.com/automate/mydsv.md)
- [myKN](https://fous.com/automate/mykn.md)
- [IPAFFS](https://fous.com/automate/ipaffs.md)
- [DGFT portal](https://fous.com/automate/dgft-portal.md)

Other industries: [NetX360+](/automate/netx360), [Maersk.com](/automate/maersk-com), [C3 Reservations](/automate/c3-reservations), [eSupplierConnect](/automate/esupplierconnect), [ILSmart](/automate/ilsmart), [PF Expert](/automate/pf-expert).

## Frequently asked questions

### Does douane.gouv.fr have an API?

Yes, as EDI for declarants, under contract. DELTA IE, DELTA H7, Gamma2 and ANTES take JSON over an API once customs has validated a contrat d'utilisation and created an API account for each téléservice. DELTA G and DELTA X use certified EDI software. Without either, you work in DELTA IE on douane.gouv.fr.

### Can I export my DELTA IE declarations?

Yes, one table or one declaration at a time. The home page tables export to CSV, and the consultation screen of a declaration edits it as PDF or downloads it as JSON or XML. With Fous, a method you build can return the same declarations and their liquidation as JSON for your own systems.

### How do I see whether a declaration has its BAE?

Open it in DELTA IE: the consultation screen shows the declaration's cycle and its état, such as BAE, sous contrôle, crédit en attente or libéré. For declarations lodged in DELTA C, DELTA D or DELTA X, the AUBETTE service shows the BAE and the ECS status from the declaration number.

### Can I change a declaration after lodging it?

Through a request, not by editing it. From mes actions you ask for a rectification or an invalidation. An invalidation request takes a motif and your own reference, and customs gives it its own reference. Annulation and modification are only for anticipated declarations.

### Is Fous affiliated with the DGDDI?

No. Fous is an independent product. You use it with your own douane.gouv.fr 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 douane.gouv.fr (Direction générale des douanes et droits indirects (DGDDI), French customs). 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.