French company API: SIREN, directors and annual accounts

Filings.fr is the REST API for official French company data: search a company by SIREN, name or director, then pull identity, legal form, share capital, registered office, NAF code, beneficial owners, annual accounts, documents and legal notices.

OpenAPI 3.1 specification: /openapi.json - open it in Postman, Insomnia or a client generator.

Your API key

My key

The public DEMO key only covers the examples on this page. Create an account to query any company (100 free calls).

Authentication

Send your key in the X-Api-Key header (recommended) or as an ?apikey= parameter (handy in the browser). Generate and rotate your key from your account.

Header authorization

Include your key in the request header: X-Api-Key: demo

Copy

URL authorization

To authorize your requests, append ?apikey=demo to every request.

Copy

Note: use &apikey= when the endpoint already has other query parameters.

Companies

Company profile

Every data point on a company, by SIREN: identity, legal form, share capital, registered office, NAF code, status and directors.

Click to try the endpoint!Endpointhttps://api.filings.fr/api/public/v1/company/775670417 Copy URL

Parameters

(*) Required

Parameter	Type	Example	Description
siren*	string	775670417	SIREN number (9 digits).

Response200Open JSON ↗ Copy response

2 "company": {

3 "id": "dc6ce189-1a6d-4318-88c2-5e328be43475",

4 "siren": "775670417",

5 "denomination": "LVMH MOET HENNESSY LOUIS VUITTON",

6 "nom_unite_legale": null,

7 "prenom_unite_legale": null,

8 "display_denomination": "LVMH MOET HENNESSY LOUIS VUITTON",

9 "sigle": null,

10 "nom_commercial": null,

11 "forme_juridique": "5800",

12 "forme_juridique_libelle": "Société européenne",

13 "date_creation": "1971-01-01T00:00:00.000Z",

14 "date_radiation": null,

15 "capital_social": null,

16 "devise_capital": "EUR",

17 "activite_principale": "70.10Z",

18 "activite_principale_libelle": "Activités des sièges sociaux",

Directors and representatives

List of directors (individuals and legal entities) with role and dates.

Click to try the endpoint!Endpointhttps://api.filings.fr/api/public/v1/company/775670417/directors Copy URL

Parameters

(*) Required

Parameter	Type	Example	Description
siren*	string	775670417	SIREN number (9 digits).

Response200Open JSON ↗ Copy response

2 "siren": "775670417",

3 "count": 32,

4 "directors": [

5 {

6 "id": "3be395b8-0935-4efc-a8a9-81bac4af2314",

7 "siren": "775670417",

8 "type": null,

9 "nom": "SIBILLE",

10 "prenom": "Jérôme Paul",

11 "denomination_pm": null,

12 "siren_pm": null,

13 "forme_juridique_pm": null,

14 "date_debut": "1997-12-16",

15 "date_fin": null,

16 "date_naissance": "1980-05-01",

17 "lieu_naissance": null,

18 "nationalite": null,

Financial data

Annual accounts: revenue, net income, headcount and balance sheets (INPI).

Click to try the endpoint!Endpointhttps://api.filings.fr/api/public/v1/company/775670417/financials Copy URL

Parameters

(*) Required

Parameter	Type	Example	Description
siren*	string	775670417	SIREN number.

Response200Open JSON ↗ Copy response

2 "siren": "775670417",

3 "count": 10,

4 "financials": [

5 {

6 "id": "33fd38f4-5003-4bf7-afe4-c7fe41ba2908",

7 "siren": "775670417",

8 "date_cloture": "2025-12-31",

9 "duree_exercice": 12,

10 "type_comptes": "C",

11 "confidentialite": "Public",

12 "chiffre_affaires": "748700000",

13 "resultat_net": "8984300000",

14 "total_bilan": "49440800000",

15 "capitaux_propres": "30555200000",

16 "effectif_moyen": null,

17 "ocr_chiffre_affaires": null,

18 "ocr_resultat_net": null,

Beneficial owners

Beneficial owners (RBE register): identities and ownership percentages.

Click to try the endpoint!Endpointhttps://api.filings.fr/api/public/v1/company/775670417/beneficiaries Copy URL

Parameters

(*) Required

Parameter	Type	Example	Description
siren*	string	775670417	SIREN number.

Response200Open JSON ↗ Copy response

2 "siren": "775670417",

3 "count": 0,

4 "beneficiaries": []

Official documents

Articles of association, deeds and accounts filed with the registry (INPI).

Click to try the endpoint!Endpointhttps://api.filings.fr/api/public/v1/company/775670417/documents Copy URL

Parameters

(*) Required

Parameter	Type	Example	Description
siren*	string	775670417	SIREN number.

Response200Open JSON ↗ Copy response

2 "siren": "775670417",

3 "actes": [

4 {

5 "id": "ftp1232531",

6 "source": "figaro",

7 "nomDocument": "LVMH-_Extrait_du_PV_du_27_07_26_reduction_du_capital_-certifie_conforme.pdf",

8 "dateDepot": "2026-07-30",

9 "downloadUrl": "/api/v1/companies/775670417/figaro/actes/ftp1232531/download",

10 "has_s3": true,

11 "has_ocr_extracted": true,

12 "figaro_document_id": "ftp1232531"

13 },

14 {

15 "id": "40169064",

16 "source": "figaro",

17 "nomDocument": "Procès verbal de décision d'assemblée générale",

18 "dateDepot": "2026-07-29",

Legal notices

BODACC filings and legal notices published by the company.

Click to try the endpoint!Endpointhttps://api.filings.fr/api/public/v1/company/775670417/announcements Copy URL

Parameters

(*) Required

Parameter	Type	Example	Description
siren*	string	775670417	SIREN number.

Response200Open JSON ↗ Copy response

2 "siren": "775670417",

3 "count": 43,

4 "announcements": [

5 {

6 "id": "c1e0f31d-35f7-4957-9173-c6b303e146f8",

7 "bodacc_id": "B202601163185",

8 "siren": "775670417",

9 "bodacc_type": "RCS-B_BXB",

10 "date_publication": "2026-06-21",

11 "numero_annonce": "3185",

12 "type_annonce": "",

13 "type_procedure": "Modifications diverses",

14 "jugement": null,

15 "date_jugement": null,

16 "tribunal": "GREFFE DU TRIBUNAL DES ACTIVITÉS ECONOMIQUES DE PARIS",

17 "contenu": {

18 "avis": {

Establishments

List of the company's establishments (SIRET).

Click to try the endpoint!Endpointhttps://api.filings.fr/api/public/v1/company/775670417/establishments Copy URL

Parameters

(*) Required

Parameter	Type	Example	Description
siren*	string	775670417	SIREN number.

Response200Open JSON ↗ Copy response

2 "siren": "775670417",

3 "count": 2,

4 "establishments": [

5 {

6 "id": "f27fecda-8af2-4428-9fd9-79c6a02cae6b",

7 "siret": "77567041700051",

8 "siren": "775670417",

9 "nic": "00051",

10 "denomination": null,

11 "enseigne": null,

12 "enseigne_2": null,

13 "enseigne_3": null,

14 "is_siege": true,

15 "date_creation": "2002-11-25",

16 "date_fermeture": null,

17 "activite_principale": "70.10Z",

18 "tranche_effectifs": "12",

Search

Search companies

Search by company name, SIREN or director.

Click to try the endpoint!Endpointhttps://api.filings.fr/api/public/v1/search?query=LVMH&limit=5 Copy URL

Parameters

(*) Required

Parameter	Type	Example	Description
query*	string	LVMH	Search term.
limit	integer	5	Results per page.
page	integer	2	Page number, from 1.

Response200Open JSON ↗ Copy response

2 "query": "LVMH",

3 "page": 1,

4 "per_page": 20,

5 "total": 219,

6 "backend": "elasticsearch",

7 "results": [

8 {

9 "id": "572082253",

10 "score": null,

11 "siren": "572082253",

12 "denomination": "LVMH FRAGRANCE BRANDS",

13 "nom_unite_legale": null,

14 "prenom_unite_legale": null,

15 "display_denomination": "LVMH FRAGRANCE BRANDS",

16 "code_naf": "20.42Z",

17 "forme_juridique": "5710",

18 "ville": null,

Directors

Director profile

Every mandate held by a person (person_id), with the related companies.

Click to try the endpoint!Endpointhttps://api.filings.fr/api/public/v1/director/228eba0b-3429-437d-af80-d35d15d30d61 Copy URL

Parameters

(*) Required

Parameter	Type	Example	Description
personId*	string	228eba0b-3429-437d-af80-d35d15d30d61	person_id identifier (UUID returned by search).

Response200Open JSON ↗ Copy response

2 "person": {

3 "personId": "228eba0b-3429-437d-af80-d35d15d30d61",

4 "displayName": "Bernard ARNAULT",

5 "dob": null,

6 "isLegalEntity": false,

7 "mandateCount": 2,

8 "currentCount": 0,

9 "formerCount": 2

10 },

11 "mandates": [

12 {

13 "siren": "652014051",

14 "denomination": "CARREFOUR",

15 "etat": "A",

16 "role": "administrateur",

17 "roleText": "Administrateur",

18 "dateStart": "2008-07-28",

Plans and pricing

You pay per call per month (1 call = 1 unit). Every plan includes every endpoint, with no per-minute rate limit.

Save up to 25 % yearly

Free

0 €

On sign-up, no card required.

100 calls / month

All REST endpoints
Company profiles and directors
Search and autocomplete
Instant API key

Choose plan →

Starter

14 €/month

billed annually

2,000 calls / month

…everything in Free, plus:

Beneficial owners
Full legal-notice history
Responses in French or English
Email support

Choose plan →

Popular

Pro

22 €/month

billed annually

10,000 calls / month

…everything in Starter, plus:

Annual accounts and balance sheets
Official documents (INPI)
Director profiles
Priority support

Choose plan →

Business

59 €/month

billed annually

30,000 calls / month

…everything in Pro, plus:

Production-grade volume
Establishments and complete data
VAT invoice and usage report
Early access to new endpoints

Choose plan →

Need more volume? From 100,000 calls/month, full data dumps or a custom SLA: we will put a plan together.

Response codes

200	OK	The request succeeded.
401	Unauthorized	Missing API key (X-Api-Key header or ?apikey=), or the key is invalid.
402	Payment Required	Monthly call limit reached (100 on the free plan). Subscribe or upgrade your plan.
404	Not Found	Resource not found.

Ready to get started?

Create a free account