# French Company Establishments Returns cursor-paginated public establishments attached to a French company from the official Sirene source, including status, activity and address. ## Endpoint - Method: `POST` - URL: `https://api.helpmyagent.com/v1/company/fr/establishments` - Price: `0.010 USD` / call ## Machine discovery - llms.txt: https://helpmyagent.com/llms.txt - OpenAPI 3.1: https://api.helpmyagent.com/openapi.json - capabilities.json: https://helpmyagent.com/capabilities.json - MCP: https://helpmyagent.com/mcp - RFC 9727: https://helpmyagent.com/.well-known/api-catalog - pricing.json: https://helpmyagent.com/pricing.json - x402: https://helpmyagent.com/.well-known/x402 - x402-service.json: https://helpmyagent.com/.well-known/x402-service.json - Health status: https://helpmyagent.com/health ## x402 payment methods - USDC on `eip155:8453` - RLUSD on `xrpl:0` ## Coverage FR ## Use when - You need the public establishments attached to a French SIREN or SIRET. ## Avoid when - You only need the company headquarters or administrative profile; use company/fr/profile. ## Limitations - Results reflect public establishments exposed by the official Sirene API; restricted non-diffusible data is not returned. - A cursor is bound to its search context and should only be reused to continue the same query. ## Freshness ```json { "mode": "source_dependent" } ``` ## Sources - [INSEE — API Sirene 3.11](https://api.insee.fr/api-sirene/3.11) ## Input schema ```json { "type": "object", "properties": { "identifier": { "type": "string", "pattern": "^[0-9]{9}([0-9]{5})?$", "description": "9-digit SIREN or 14-digit SIRET" }, "cursor": { "type": "string", "minLength": 1, "maxLength": 4096, "default": "*", "description": "Opaque Sirene cursor from next_cursor; omit it on the first call" }, "limit": { "type": "integer", "minimum": 1, "maximum": 100, "default": 25, "description": "Maximum establishments to return, up to 100" } }, "required": [ "identifier" ], "additionalProperties": false, "description": "Structured input parameters for the company/fr/establishments API." } ``` ## Output schema ```json { "type": "object", "properties": { "identifier": { "type": "string", "description": "Identifier supplied for the request, echoed in normalized form when applicable." }, "identifier_type": { "type": "string", "enum": [ "siren", "siret" ], "description": "Normalized identifier type, such as SIREN or SIRET when applicable. (allowed values: siren, siret)." }, "siren": { "type": "string", "description": "Normalized 9-digit French SIREN when available." }, "exists": { "type": "boolean", "description": "Whether the requested company or public record was found in the checked source." }, "cursor": { "type": "string", "description": "Structured value returned for “cursor” as defined by this API contract." }, "next_cursor": { "type": [ "string", "null" ], "description": "Structured value returned for “next cursor” as defined by this API contract." }, "limit": { "type": "integer", "description": "Structured value returned for “limit” as defined by this API contract." }, "total_count": { "type": "integer", "description": "Total number of matching records reported by the source or endpoint." }, "returned_count": { "type": "integer", "description": "Number of records included in this response." }, "truncated": { "type": "boolean", "description": "Whether additional matching records existed beyond the returned result limit." }, "establishments": { "type": "array", "items": { "type": "object", "properties": { "siret": { "type": [ "string", "null" ], "description": "Normalized 14-digit French SIRET when available." }, "status": { "type": [ "string", "null" ], "enum": [ "active", "closed", null ], "description": "Normalized endpoint or source status. (allowed values: active, closed)." }, "is_headquarters": { "type": [ "boolean", "null" ], "description": "Structured value returned for “is headquarters” as defined by this API contract." }, "activity_code": { "type": [ "string", "null" ], "description": "Structured value returned for “activity code” as defined by this API contract." }, "activity_nomenclature": { "type": [ "string", "null" ], "description": "Structured value returned for “activity nomenclature” as defined by this API contract." }, "creation_date": { "type": [ "string", "null" ], "description": "Structured value returned for “creation date” as defined by this API contract." }, "closure_date": { "type": [ "string", "null" ], "description": "Structured value returned for “closure date” as defined by this API contract." }, "employee_band_code": { "type": [ "string", "null" ], "description": "Structured value returned for “employee band code” as defined by this API contract." }, "employee_band_year": { "type": [ "string", "null" ], "description": "Structured value returned for “employee band year” as defined by this API contract." }, "is_employer": { "type": [ "boolean", "null" ], "description": "Structured value returned for “is employer” as defined by this API contract." }, "address": { "type": [ "string", "null" ], "description": "Structured value returned for “address” as defined by this API contract." }, "postal_code": { "type": [ "string", "null" ], "description": "Structured value returned for “postal code” as defined by this API contract." }, "city": { "type": [ "string", "null" ], "description": "Structured value returned for “city” as defined by this API contract." }, "commune_code": { "type": [ "string", "null" ], "description": "Structured value returned for “commune code” as defined by this API contract." }, "last_processed_at": { "type": [ "string", "null" ], "description": "Structured value returned for “last processed at” as defined by this API contract." } }, "required": [ "siret", "status", "is_headquarters", "activity_code", "activity_nomenclature", "creation_date", "closure_date", "employee_band_code", "employee_band_year", "is_employer", "address", "postal_code", "city", "commune_code", "last_processed_at" ], "additionalProperties": false }, "description": "Structured value returned for “establishments” as defined by this API contract." } }, "required": [ "identifier", "identifier_type", "siren", "exists", "cursor", "next_cursor", "limit", "total_count", "returned_count", "truncated", "establishments" ], "additionalProperties": false, "description": "Structured result returned by the company/fr/establishments API." } ``` ## Request example ```json { "identifier": "356000000", "limit": 25 } ``` ## Billing policy ```json { "charge_on": "valid_result", "no_charge_on_error": true, "no_charge_on_empty_result": true } ```