When should you use this API?
Use cases and limitations are published with the API so humans and agents can integrate it correctly.
Use when
- You have a French SIREN or SIRET and need to confirm that the company or establishment exists in the public source.
- You need its current administrative active/closed status before another automated step.
Avoid when
- You only have a company name and need to discover its identifier; use company/fr/search.
- You need directors, financials, legal risk or compliance checks; use the corresponding specialized endpoint.
Limitations
- This verifies public administrative existence and status only; it is not KYC, identity assurance or beneficial-owner verification.
- Returned fields depend on what the public company source exposes for the identifier.
Sources and provenance
Sources published for this endpoint are shown directly with their original link.
API Recherche d'entreprises
recherche-entreprises.api.gouv.fr
Stored real response
This snapshot is served from published database data without executing the paid API.
Request
{
"identifier": "356000000"
}Stored response
{
"identifier": "356000000",
"identifier_type": "siren",
"exists": true,
"active": true,
"siren": "356000000",
"siret": "35600000000048",
"name": "LA POSTE",
"activity_code": "53.10Z",
"address": "DIRECTION GENERALE DE LA POSTE 9 RUE DU COLONEL PIERRE AVIA 75015 PARIS",
"postal_code": "75015",
"city": "PARIS"
}Billing policy
0.005 $ / call · charged on valid result · errors not charged.
Input / Output schemas
Simplified endpoint contracts. The complete schema remains available in OpenAPI 3.1.
Input schema
identifierstringRequired · 9-digit SIREN or 14-digit SIRETView full JSON Schema
{
"type": "object",
"properties": {
"identifier": {
"type": "string",
"pattern": "^[0-9]{9}([0-9]{5})?$",
"description": "9-digit SIREN or 14-digit SIRET"
}
},
"required": [
"identifier"
],
"additionalProperties": false
}Output schema
identifierstringRequiredidentifier_typestringRequiredexistsbooleanRequiredactiveboolean | nullRequiredsirenstring | nullRequiredsiretstring | nullRequirednamestring | nullRequiredactivity_codestring | nullRequiredaddressstring | nullRequiredpostal_codestring | nullRequiredcitystring | nullRequiredView full JSON Schema
{
"type": "object",
"properties": {
"identifier": {
"type": "string"
},
"identifier_type": {
"type": "string",
"enum": [
"siren",
"siret"
]
},
"exists": {
"type": "boolean"
},
"active": {
"type": [
"boolean",
"null"
]
},
"siren": {
"type": [
"string",
"null"
]
},
"siret": {
"type": [
"string",
"null"
]
},
"name": {
"type": [
"string",
"null"
]
},
"activity_code": {
"type": [
"string",
"null"
]
},
"address": {
"type": [
"string",
"null"
]
},
"postal_code": {
"type": [
"string",
"null"
]
},
"city": {
"type": [
"string",
"null"
]
}
},
"required": [
"identifier",
"identifier_type",
"exists",
"active",
"siren",
"siret",
"name",
"activity_code",
"address",
"postal_code",
"city"
],
"additionalProperties": false
}Example queries
Queries published with the API to help select the right endpoint.
Does SIREN 356000000 exist and is it active?
Verify this French SIRET before I continue.
Is this establishment still active?