Official registries
Check an EU VAT number with VIES, and search or read French companies in the public company registry. No key is needed. Typical uses: check a customer VAT number before invoicing, fill a company record from its SIREN.
vat check_viesvat check_viesvat check_viescompany search_frcompany search_frcompany get_frcompany get_fr
vat check_vies <vat_number>
Description
Check an EU VAT number written with its country code (EL for Greece, XI for Northern Ireland). Returns {country_code, vat_number, valid, name, address, request_date, request_identifier, source}: name and address are null when the member state does not give them
Check an EU VAT number written with its country code (EL for Greece, XI for Northern Ireland). Returns {country_code, vat_number, valid, name, address, request_date, request_identifier, source}: name and address are null when the member state does not give them
Parameters
vat_number: The VAT number with its country code, ex: IE6388047V - String - required
vat_number: The VAT number with its country code, ex: IE6388047V - String - required
admin
vat check_vies "IE6388047V"
mentdb
{"country_code": "IE", "vat_number": "6388047V", "valid": true, "name": "GOOGLE IRELAND LIMITED", "address": "3RD FLOOR, GORDON HOUSE, BARROW STREET, DUBLIN 4", "request_date": "2026-11-10T10:46:06.388Z", "request_identifier": null, "source": "VIES, European Commission"}
A number with a wrong format is refused before any call
admin
vat check_vies "FR12345"
mentdb
ERROR: Sorry, an error appears ('FR12345' is not a valid EU VAT number format (checked with type is_vat_eu)).
vat check_vies <country_code> <number>
Description
Check an EU VAT number given as a country code and a number (spaces, dots and dashes are removed; the country code may be repeated in the number)
Check an EU VAT number given as a country code and a number (spaces, dots and dashes are removed; the country code may be repeated in the number)
Parameters
country_code: The country code (2 letters) - String - required
number: The number - String - required
country_code: The country code (2 letters) - String - required
number: The number - String - required
admin
vat check_vies "BE" "0403.170.701"
mentdb
{"country_code": "BE", "vat_number": "0403170701", "valid": true, "name": "SA ELECTRABEL", "address": "Boulevard Simon Bolivar 36, 1000 Bruxelles", "request_date": "2026-11-10T10:44:18.403Z", "request_identifier": null, "source": "VIES, European Commission"}
vat check_vies <country_code> <number> <json_params>
Description
Check an EU VAT number with parameters: timeout_ms (20000), requester_country and requester_number (your own VAT number: VIES then gives a request_identifier, the proof of the check), endpoint
Check an EU VAT number with parameters: timeout_ms (20000), requester_country and requester_number (your own VAT number: VIES then gives a request_identifier, the proof of the check), endpoint
Parameters
country_code: The country code (2 letters) - String - required
number: The number - String - required
json_params: The parameters - String - required
country_code: The country code (2 letters) - String - required
number: The number - String - required
json_params: The parameters - String - required
admin
vat check_vies "FR" "40303265045" "{\"timeout_ms\": 10000}"
mentdb
Sorry, an error appears (the VIES service of FR has too many requests now (MS_MAX_CONCURRENT_REQ): try again later).
company search_fr <query>
Description
Search French companies by name, words, SIREN or SIRET (3 characters at least): {total, page, per_page, total_pages, results, source}. Each result: siren, name, legal_name, acronym, naf, legal_form (code of the INSEE nomenclature), category (PME, ETI, GE), creation_date, closing_date, state (active, closed), headcount_code (INSEE code of the headcount range), establishments, open_establishments, vat_number (intra-community number computed from the SIREN), head_office {siret, head_office, address, postal_code, city, city_code, naf, creation_date, state, latitude, longitude}
Search French companies by name, words, SIREN or SIRET (3 characters at least): {total, page, per_page, total_pages, results, source}. Each result: siren, name, legal_name, acronym, naf, legal_form (code of the INSEE nomenclature), category (PME, ETI, GE), creation_date, closing_date, state (active, closed), headcount_code (INSEE code of the headcount range), establishments, open_establishments, vat_number (intra-community number computed from the SIREN), head_office {siret, head_office, address, postal_code, city, city_code, naf, creation_date, state, latitude, longitude}
Parameters
query: The words to search - String - required
query: The words to search - String - required
admin
company search_fr "303265045"
mentdb
{"total": 1, "page": 1, "per_page": 10, "total_pages": 1, "results": [{"siren": "303265045", "name": "SODIMAS", "legal_name": "SODIMAS", "acronym": null, "naf": "28.22Z", "legal_form": "5599", "category": "ETI", "creation_date": "1975-08-21", "closing_date": null, "state": "active", "headcount_code": "32", "establishments": 4, "open_establishments": 2, "vat_number": "FR40303265045", "head_office": {"siret": "30326504500029", "head_office": true, "address": "11 RUE AMPERE 26600 PONT-DE-L'ISERE", "postal_code": "26600", "city": "PONT-DE-L'ISERE", "city_code": "26250", "naf": "28.22Z", "creation_date": "1975-08-21", "state": "active", "latitude": 45.013289271, "longitude": 4.8744239448}}], "source": "API Recherche d'entreprises (recherche-entreprises.api.gouv.fr), Etalab licence 2.0"}
company search_fr <query> <json_params>
Description
Search with parameters: page (1), per_page (10, 25 at most), postal_code, department, naf (ex: 10.71C), legal_form (4 digits), state (A active, C closed), category (PME, ETI, GE), timeout_ms, endpoint. With a filter, query may be empty
Search with parameters: page (1), per_page (10, 25 at most), postal_code, department, naf (ex: 10.71C), legal_form (4 digits), state (A active, C closed), category (PME, ETI, GE), timeout_ms, endpoint. With a filter, query may be empty
Parameters
query: The words to search - String - required
json_params: The parameters - String - required
query: The words to search - String - required
json_params: The parameters - String - required
admin
company search_fr "boulangerie" "{\"postal_code\": \"97400\", \"state\": \"A\", \"per_page\": 2}"
mentdb
{"total": 82, "page": 1, "per_page": 2, "total_pages": 41, "results": [{"siren": "498626977", "name": "BOULANGERIE JEEWA", "legal_name": "BOULANGERIE JEEWA", "acronym": null, "naf": "10.71B", "legal_form": "5499", "category": "PME", "creation_date": "2007-06-20", "closing_date": null, "state": "active", "headcount_code": "NN", "establishments": 3, "open_establishments": 1, "vat_number": null, "head_office": {"siret": "49862697700033", "head_office": true, "address": "26 AVENUE STANISLAS GIMART 97490 SAINT-DENIS", "postal_code": "97490", "city": "SAINT-DENIS", "city_code": "97411", "naf": "10.71B", "creation_date": "2010-01-01", "state": "active", "latitude": -20.89612148, "longitude": 55.47469112}}, {"siren": "894687847", "name": "BOULANGERIE CAMELIAS", "legal_name": "BOULANGERIE CAMELIAS", "acronym": null, "naf": "00.00Z", "legal_form": "5710", "category": "PME", "creation_date": "2021-01-14", "closing_date": null, "state": "active", "headcount_code": "NN", "establishments": 1, "open_establishments": 1, "vat_number": "FR27894687847", "head_office": {"siret": "89468784700018", "head_office": true, "address": "14 BOULEVARD DORET 97400 SAINT-DENIS", "postal_code": "97400", "city": "SAINT-DENIS", "city_code": "97411", "naf": "70.10Z", "creation_date": "2021-01-14", "state": "active", "latitude": -20.8909694, "longitude": 55.461176783}}], "source": "API Recherche d'entreprises (recherche-entreprises.api.gouv.fr), Etalab licence 2.0"}
company get_fr <siren_or_siret>
Description
One French company by its SIREN (9 digits) or SIRET (14 digits, the establishment is added): {found: true, the fields of company search_fr, establishment (SIRET only), source} or {found: false, siren}
One French company by its SIREN (9 digits) or SIRET (14 digits, the establishment is added): {found: true, the fields of company search_fr, establishment (SIRET only), source} or {found: false, siren}
Parameters
siren_or_siret: The SIREN or SIRET - String - required
siren_or_siret: The SIREN or SIRET - String - required
admin
company get_fr "30326504500029"
mentdb
{"found": true, "siren": "303265045", "name": "SODIMAS", "legal_name": "SODIMAS", "acronym": null, "naf": "28.22Z", "legal_form": "5599", "category": "ETI", "creation_date": "1975-08-21", "closing_date": null, "state": "active", "headcount_code": "32", "establishments": 4, "open_establishments": 2, "vat_number": "FR40303265045", "head_office": {"siret": "30326504500029", "head_office": true, "address": "11 RUE AMPERE 26600 PONT-DE-L'ISERE", "postal_code": "26600", "city": "PONT-DE-L'ISERE", "city_code": "26250", "naf": "28.22Z", "creation_date": "1975-08-21", "state": "active", "latitude": 45.013289271, "longitude": 4.8744239448}, "establishment": {"siret": "30326504500029", "head_office": true, "address": "11 RUE AMPERE 26600 PONT-DE-L'ISERE", "postal_code": "26600", "city": "PONT-DE-L'ISERE", "city_code": "26250", "naf": "28.22Z", "creation_date": "1975-08-21", "state": "active", "latitude": 45.013289271, "longitude": 4.8744239448}, "source": "API Recherche d'entreprises (recherche-entreprises.api.gouv.fr), Etalab licence 2.0"}
An invalid SIREN (Luhn key) is refused before any call
admin
company get_fr "123456789"
mentdb
ERROR: Sorry, an error appears ('123456789' is not a valid SIREN (checked with type is_siren)).
company get_fr <siren_or_siret> <json_params>
Description
One French company with parameters: timeout_ms (20000), endpoint
One French company with parameters: timeout_ms (20000), endpoint
Parameters
siren_or_siret: The SIREN or SIRET - String - required
json_params: The parameters - String - required
siren_or_siret: The SIREN or SIRET - String - required
json_params: The parameters - String - required
admin
company get_fr "303265045" "{\"endpoint\": \"http://127.0.0.1:32999\", \"timeout_ms\": 2000}"
mentdb
ERROR: Sorry, an error appears (cannot connect to the API Recherche d'entreprises (refused or unreachable)).
