API Recherche d'entreprises
recherche-entreprises.api.gouv.frFrench Company Profile
Returns the public profile of a French company from a SIREN or SIRET.
0.005 USD
Charged on valid result · Empty result not charged · Errors not charged
When to use this API?
Use for
- You need a normalized public administrative profile for a French company from its SIREN or SIRET.
- You need headquarters, activity, legal-form, creation-date, employee-band or establishment-count fields in one response.
Avoid when
- You only need a yes/no existence or active-status check; use company/fr/verify.
- You need directors, financial statements, legal risk or compliance results; use the dedicated endpoint.
Limitations
- Some profile fields can be null when the public source does not expose them for the company.
- This endpoint does not replace the specialized directors, financials, risk or compliance endpoints.
Sources and provenance
Input / Output schemas
Simplified endpoint contracts. The complete schema remains available in OpenAPI 3.1.
Input schema
identifierstringRequired · 9-digit SIREN or 14-digit SIRET
View 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
identifierstringRequired
identifier_typestringRequired
existsbooleanRequired
sirenstring | nullRequired
namestring | nullRequired
statusstring | nullRequired
legal_form_codestring | nullRequired
creation_datestring | nullRequired
closure_datestring | nullRequired
activity_codestring | nullRequired
company_categorystring | nullRequired
employee_band_codestring | nullRequired
employee_band_yearstring | nullRequired
is_employerboolean | nullRequired
establishments_countinteger | nullRequired
open_establishments_countinteger | nullRequired
headquartersobject | nullRequired
View full JSON Schema
{
"type": "object",
"properties": {
"identifier": {
"type": "string"
},
"identifier_type": {
"type": "string",
"enum": [
"siren",
"siret"
]
},
"exists": {
"type": "boolean"
},
"siren": {
"type": [
"string",
"null"
]
},
"name": {
"type": [
"string",
"null"
]
},
"status": {
"type": [
"string",
"null"
]
},
"legal_form_code": {
"type": [
"string",
"null"
]
},
"creation_date": {
"type": [
"string",
"null"
]
},
"closure_date": {
"type": [
"string",
"null"
]
},
"activity_code": {
"type": [
"string",
"null"
]
},
"company_category": {
"type": [
"string",
"null"
]
},
"employee_band_code": {
"type": [
"string",
"null"
]
},
"employee_band_year": {
"type": [
"string",
"null"
]
},
"is_employer": {
"type": [
"boolean",
"null"
]
},
"establishments_count": {
"type": [
"integer",
"null"
]
},
"open_establishments_count": {
"type": [
"integer",
"null"
]
},
"headquarters": {
"type": [
"object",
"null"
],
"properties": {
"siret": {
"type": [
"string",
"null"
]
},
"status": {
"type": [
"string",
"null"
]
},
"activity_code": {
"type": [
"string",
"null"
]
},
"creation_date": {
"type": [
"string",
"null"
]
},
"address": {
"type": [
"string",
"null"
]
},
"postal_code": {
"type": [
"string",
"null"
]
},
"city": {
"type": [
"string",
"null"
]
},
"department": {
"type": [
"string",
"null"
]
},
"region": {
"type": [
"string",
"null"
]
},
"latitude": {
"type": [
"string",
"null"
]
},
"longitude": {
"type": [
"string",
"null"
]
}
}
}
},
"required": [
"identifier",
"identifier_type",
"exists",
"siren",
"name",
"status",
"legal_form_code",
"creation_date",
"closure_date",
"activity_code",
"company_category",
"employee_band_code",
"employee_band_year",
"is_employer",
"establishments_count",
"open_establishments_count",
"headquarters"
],
"additionalProperties": false
}Example queries
Give me the public profile of SIREN 356000000.
Where is this French company headquartered and what is its activity code?
How many establishments does this company have?