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 explainable public legal-risk signals for a French company, including insolvency proceedings, deregistrations and administrative closure.
- You need a normalized low, warning, high or unknown legal-risk level backed by public events.
Avoid when
- You need a credit score, probability of default, payment behavior or bank-grade solvency assessment.
- You need sanctions or regulatory blacklist screening; use company/fr/compliance.
Limitations
- The BODACC analysis uses a 10-year lookback and reports when source coverage is insufficient to conclude.
- This is a public legal-risk signal service, not a credit score or legal 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
BODACC Open Data
bodacc-datadila.opendatasoft.com
Stored real response
This snapshot is served from published database data without executing the paid API.
Request
{
"identifier": "951470822"
}Stored response
{
"identifier": "951470822",
"identifier_type": "siren",
"exists": true,
"siren": "951470822",
"name": "R'NEO FRANCE (R'NEO)",
"company_status": "active",
"risk_level": "high",
"assessment_basis": "bodacc_legal_events",
"lookback_years": 10,
"coverage_complete": true,
"signals": {
"company_closed": false,
"collective_procedure_events": 1,
"radiation_events": 0
},
"latest_event": {
"id": "A202601325135",
"type": "collective_procedure",
"publication_date": "2026-07-14",
"decision_date": "2026-07-08",
"family": "Procédures collectives",
"decision_type": "Jugement d'ouverture de liquidation judiciaire",
"description": "Jugement prononçant la liquidation judiciaire 08/07/2026, date de cessation des paiements le 31 Mai 2026, désignant liquidateur SELARL LEX MJ, prise en la personne de Maître Lucie MARGOTTIN 11, rue Jean Bodin - CS 80502 - 49105 Angers . Les créances sont à adresser, dans les deux mois de la présente publication, auprès du liquidateur ou sur le portail électronique prévu par les articles L. 814-2 et L. 814-13 du code de commerce.",
"tribunal": "Greffe du Tribunal de Commerce d'Angers",
"url": "https://www.bodacc.fr/pages/annonces-commerciales-detail/?q.id=id:A202601325135"
},
"events": [
{
"id": "A202601325135",
"type": "collective_procedure",
"publication_date": "2026-07-14",
"decision_date": "2026-07-08",
"family": "Procédures collectives",
"decision_type": "Jugement d'ouverture de liquidation judiciaire",
"description": "Jugement prononçant la liquidation judiciaire 08/07/2026, date de cessation des paiements le 31 Mai 2026, désignant liquidateur SELARL LEX MJ, prise en la personne de Maître Lucie MARGOTTIN 11, rue Jean Bodin - CS 80502 - 49105 Angers . Les créances sont à adresser, dans les deux mois de la présente publication, auprès du liquidateur ou sur le portail électronique prévu par les articles L. 814-2 et L. 814-13 du code de commerce.",
"tribunal": "Greffe du Tribunal de Commerce d'Angers",
"url": "https://www.bodacc.fr/pages/annonces-commerciales-detail/?q.id=id:A202601325135"
}
]
}Billing policy
0.010 $ / 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_typestringRequiredexistsbooleanRequiredsirenstring | nullRequirednamestring | nullRequiredcompany_statusstring | nullRequiredrisk_levelstring | nullRequiredassessment_basisstringRequiredlookback_yearsintegerRequiredcoverage_completeboolean | nullRequiredsignalsobjectRequiredlatest_eventobject | nullRequiredeventsarrayRequiredView 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"
]
},
"company_status": {
"type": [
"string",
"null"
]
},
"risk_level": {
"type": [
"string",
"null"
],
"enum": [
"low",
"warning",
"high",
"unknown",
null
]
},
"assessment_basis": {
"type": "string"
},
"lookback_years": {
"type": "integer"
},
"coverage_complete": {
"type": [
"boolean",
"null"
]
},
"signals": {
"type": "object",
"properties": {
"company_closed": {
"type": [
"boolean",
"null"
]
},
"collective_procedure_events": {
"type": "integer"
},
"radiation_events": {
"type": "integer"
}
},
"required": [
"company_closed",
"collective_procedure_events",
"radiation_events"
],
"additionalProperties": false
},
"latest_event": {
"type": [
"object",
"null"
]
},
"events": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": [
"string",
"null"
]
},
"type": {
"type": "string",
"enum": [
"collective_procedure",
"radiation"
]
},
"publication_date": {
"type": "string"
},
"decision_date": {
"type": [
"string",
"null"
]
},
"family": {
"type": [
"string",
"null"
]
},
"decision_type": {
"type": [
"string",
"null"
]
},
"tribunal": {
"type": [
"string",
"null"
]
},
"url": {
"type": [
"string",
"null"
]
}
}
}
}
},
"required": [
"identifier",
"identifier_type",
"exists",
"siren",
"name",
"company_status",
"risk_level",
"assessment_basis",
"lookback_years",
"coverage_complete",
"signals",
"latest_event",
"events"
],
"additionalProperties": false
}Example queries
Queries published with the API to help select the right endpoint.
Does this French company show public insolvency risk signals?
Has SIREN 356000000 been deregistered or subject to collective proceedings?
Explain the public legal-risk level for this company.