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

Parameters

    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)

Parameters

    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

Parameters

    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}

Parameters

    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

Parameters

    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}

Parameters

    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

Parameters

    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)).