# french-company-check-v1

> Legal identity and risk check for French companies. A SIREN, a SIRET or a company name in; one verdict out, reconciled from three public registries (SIRENE/RNE, BODACC, VIES).

## Endpoint

`POST https://api.getcompanycheck.com/v1/company`, JSON body. All inputs are in the body; no header changes the answer. Also on Pocket Network, service ID `french-company-check-v1`.

## Input

Exactly one of:
- `siren`: 9 digits
- `siret`: 14 digits
- `q`: company or director name, full-text

Optional: `include_insolvency`, `include_vat` (bool, default true), `notices_limit` (0–20, default 3), `directors_limit` (0–25, default 3; 0 omits officers), `verbose` (bool).

Example: `{"siren": "120027016", "directors_limit": 0}`

## Output

Every 200 has the same keys, whatever the status:
- `status`: `found`, `ambiguous`, `not_found`, `source_unavailable` or `error`
- `action_required`: true iff `flags` is non-empty. Branch on this.
- `flags`: reasons, e.g. `adverse_notices_recent`, `company_ceased`, `source_degraded:vies`
- `complete`: false as soon as one source did not answer; a degraded check never reads as clear
- `sources`: per source, `ok`, `skipped`, `unavailable`, `rate_limited`, `timeout` or `error`
- `company`: legal name, SIREN, SIRET, address, NAF code, state, incorporation date, officers, VAT number
- `insolvency`: BODACC counts over the full history (total, by family, adverse, recent adverse over 5 years), latest adverse notice dated
- `vat`: VIES validity, or null
- `data_as_of`: UTC timestamp

Never a 5xx; answers within 9 s. Bad input: 400 `{"service", "error": {"code", "message"}}`. Direct calls are limited to 60 per minute per IP address (bursts of 10): beyond, 429 with code `rate_limited` and a `Retry-After` header.

Officers' names are personal data from the French trade register: 3 by default, none with `directors_limit: 0`.

## Links

- [API documentation](https://getcompanycheck.com/docs): parameters, all 13 flags, example response
- [Operator guide](https://getcompanycheck.com/operators): running a Pocket Network supplier
- [OpenAPI schema](https://api.getcompanycheck.com/v1/openapi.json)