Catalog / Company registries & public records
COMPANY REGISTRIES & PUBLIC RECORDS · FRANCE
France Company Registry & Legal Notices
Look up French companies by name, SIREN, activity, department or size and export registry details with their latest BODACC legal announcements, insolvency status and officers.
About this data
Look up French companies by name, SIREN, activity, department or size and export registry details with their latest BODACC legal announcements, insolvency status and officers.
From the actor’s Apify Store listing. The per-call endpoint may return a bounded subset; its own description is below.
Buy per call over x402
One endpoint at api.ssh.autos. Each call is one JSON POST, paid in USDC with no account or API key, and answered in the same HTTP response.
POST /v1/fr/companies/search
Records include SIREN/SIRET identifiers, names, legal forms, activity codes, creation dates, administrative status, establishment counts, headquarters and registry source links.
Fetch one search page with up to 20 French companies.
Filter by company name, department, postal code, NAF activity, company-size category and active status.
Financial figures appear when published.
BODACC announcement and insolvency enrichment are disabled; no officer-profile requests are made.
Input
Send a JSON body to POST https://api.ssh.autos/v1/fr/companies/search.
| Field | Type | Required | Notes |
|---|---|---|---|
query | string | optional | 3–160 characters; default "boulangerie" |
departement | string | optional | pattern ^(?:[0-9]{2,3}|2[AB])$ |
postalCode | string | optional | pattern ^[0-9]{5}$ |
nafCodes | array of strings | optional | up to 3 items |
categorieEntreprise | array of strings | optional | each one of PME, ETI, GE; up to 3 items |
activeOnly | boolean | optional | default true |
maxItems | integer | optional | 1–20; default 10 |
Returned fields
The answer is JSON: records, a list of up to 20, and summary, the run status and counts. Each record has these 36 fields; a field the source does not publish comes back null.
36 fields per record
| Field | Type | Notes |
|---|---|---|
siren | string | Nine-digit SIREN of the legal unit, as published. |
name | string | Published company name (nom complet). |
legalName | string | Published registered name (nom ou raison sociale). |
sigle | string | Published acronym, when the register carries one. |
siretSiege | string | SIRET of the head office establishment, when published. |
nafCode | string | Published primary activity code (NAF/APE), e.g. 10.71A. |
nafCode2025 | string | Primary activity in the NAF 2025 revision, when the source publishes it. |
nafSection | string | Section letter of the primary activity. |
natureJuridique | string | Legal nature code, as published. |
categorieEntreprise | string | Company size category: PME, ETI or GE. |
anneeCategorieEntreprise | string | Year the size category applies to. |
trancheEffectifSalarie | string | Published employee-count band code. |
anneeTrancheEffectifSalarie | string | Year the employee-count band applies to. |
dateCreation | string | Company creation date, ISO 8601 calendar date. |
dateFermeture | string | Closure date when the company is closed. |
etatAdministratif | string | Administrative state: A active, C ceased. one of A, C |
nombreEtablissements | integer | Number of establishments on record. |
nombreEtablissementsOuverts | integer | Number of open establishments on record. |
statutDiffusion | string | Published diffusion status of the record. |
commercialProspectingOptOut | boolean or string | Published opposition to commercial prospecting (opposition_diffusion_commerciale), verbatim; null when the source omits it. |
caractereEmployeur | string | Published employer status of the legal unit (caractere_employeur), verbatim. |
siege | object | Head office address and identifiers as published; null when the source omits it. |
dirigeants | array of objects | Officers as published, in source order. Natural persons and legal persons keep their published fields. |
finances | array of objects | Published financial years, newest first. Amounts are euros exactly as published. |
bodaccAnnouncements | array of objects | Newest legal announcements for this SIREN, up to maxAnnouncementsPerCompany. Empty when announcements are switched off or none exist. |
hasInsolvencyProceeding | boolean | True when a collective proceeding, conciliation or professional recovery notice listing this SIREN exists; null when announcements were not requested or the lookup was incomplete. |
bodaccStatus | string | Announcement lookup outcome: ok, unavailable (failed or partial, so the flag is null) or not_requested. one of ok, unavailable, not_requested |
lastAnnouncementAt | string | Most recent announcement publication date returned for the SIREN. |
bodaccAnnouncementCount | integer | Total announcements on record for the SIREN, including those beyond maxAnnouncementsPerCompany. |
announcementsError | string | Why announcements could not be checked for this company; null when the check completed. |
sourceUrl | string | Link to the company's official public directory page. |
sources | array of objects | Open data sources used for this row, with the source page and licence. |
sourceUpdatedAt | string | Source's own last-update timestamp for the combined record (date_mise_a_jour), verbatim. |
sourceUpdatedAtInsee | string | Source's own last-update timestamp for the INSEE Sirene part (date_mise_a_jour_insee), verbatim. |
sourceUpdatedAtRne | string | Source's own last-update timestamp for the RNE part (date_mise_a_jour_rne), verbatim. |
observedAt | string | UTC ISO 8601 timestamp of this collection. |
Example call
npx agentcash@latest fetch https://api.ssh.autos/v1/fr/companies/search -m POST -b '{"query": "boulangerie", "maxItems": 5}'The example values come from the API spec or the actor’s own sample input. Running it is a paid call.
What is and isn’t charged
You pay the call price for
- An answer, including a definitive “not found” or an empty result.
- Confirmed no matches returns records: [] (charged: it is an answer).
Free
- Invalid input (422), busy (503), source failure (502), timeout (504) and calls whose client hung up are never charged.
- Invalid input and source failures are not charged.
Prefer a subscription? Run it on Apify
This data source is a public actor on the Apify Store: France Company Registry & Legal Notices. Run it with your Apify account and plan for larger, scheduled or exported runs; it may offer more input options than the per-call endpoint.
How x402 payment works
- Your client sends the request. The API answers
402 Payment Requiredwith the price and where to pay. - The client pays from its own wallet: USDC on Base or Solana over x402, or over MPP on Tempo. No account, sign-up or API key.
- The client retries with the payment attached and gets the JSON answer in the same call. You are only charged for answers.
The AgentCash CLI in the example does all three steps for you and pays from your AgentCash wallet. Any x402 or MPP client works the same way.
Machine-readable: openapi.json · llms.txt