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 need publicly available revenue or net-income figures for a French company.
- You need a normalized multi-year financial history with simple revenue-growth and net-margin calculations when data is available.
Avoid when
- You need real-time management accounts, bank data, a company valuation or a credit score.
- You only need administrative identity or status; use company/fr/profile or company/fr/verify.
Limitations
- Financial years are returned only when the public company source exposes filed financial data.
- Missing or confidential accounts can produce incomplete histories; this service is not a credit assessment or audit opinion.
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,
"siren": "356000000",
"name": "LA POSTE",
"summary": {
"years_available": 1,
"latest_year": "2024",
"latest_revenue": 34569000000,
"latest_net_income": 1722000000,
"latest_revenue_growth_percent": null,
"latest_net_margin_percent": 4.98
},
"financials": [
{
"year": "2024",
"revenue": 34569000000,
"net_income": 1722000000,
"revenue_growth_percent": null,
"net_margin_percent": 4.98
}
]
}Billing policy
0.010 $ / call · charged on valid result · empty result not charged · 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_typestringRequiredexistsbooleanRequiredsirenstring | nullRequirednamestring | nullRequiredsummaryobjectRequiredfinancialsarrayRequiredView 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"
]
},
"summary": {
"type": "object",
"properties": {
"years_available": {
"type": "integer"
},
"latest_year": {
"type": [
"string",
"null"
]
},
"latest_revenue": {
"type": [
"number",
"null"
]
},
"latest_net_income": {
"type": [
"number",
"null"
]
},
"latest_revenue_growth_percent": {
"type": [
"number",
"null"
]
},
"latest_net_margin_percent": {
"type": [
"number",
"null"
]
}
},
"required": [
"years_available",
"latest_year",
"latest_revenue",
"latest_net_income",
"latest_revenue_growth_percent",
"latest_net_margin_percent"
],
"additionalProperties": false
},
"financials": {
"type": "array",
"items": {
"type": "object",
"properties": {
"year": {
"type": "string"
},
"revenue": {
"type": [
"number",
"null"
]
},
"net_income": {
"type": [
"number",
"null"
]
},
"revenue_growth_percent": {
"type": [
"number",
"null"
]
},
"net_margin_percent": {
"type": [
"number",
"null"
]
}
},
"required": [
"year",
"revenue",
"net_income",
"revenue_growth_percent",
"net_margin_percent"
],
"additionalProperties": false
}
}
},
"required": [
"identifier",
"identifier_type",
"exists",
"siren",
"name",
"summary",
"financials"
],
"additionalProperties": false
}Example queries
Queries published with the API to help select the right endpoint.
What is the latest available revenue for SIREN 356000000?
Show me this company’s public revenue trend.
What is its latest public net income and net margin?