helpmyagent.com
FR Connect my AI
☰

French Company Establishments

Returns cursor-paginated public establishments attached to a French company from the official Sirene source, including status, activity and address.

0.010 USD

Charged on valid result · Empty result not charged · Errors not charged

When to use this API?

Use for

  • 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.

Sources and provenance

INSEE — API Sirene 3.11

api.insee.fr

Input / Output schemas

Simplified endpoint contracts. The complete schema remains available in OpenAPI 3.1.

OpenAPI 3.1 →

Input schema
identifierstring

Required · 9-digit SIREN or 14-digit SIRET

cursorstring

Opaque Sirene cursor from next_cursor; omit it on the first call

limitinteger

Maximum establishments to return, up to 100

View full JSON Schema
{
    "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
}
Output schema
identifierstring

Required

identifier_typestring

Required

sirenstring

Required

existsboolean

Required

cursorstring

Required

next_cursorstring | null

Required

limitinteger

Required

total_countinteger

Required

returned_countinteger

Required

truncatedboolean

Required

establishmentsarray

Required

View full JSON Schema
{
    "type": "object",
    "properties": {
        "identifier": {
            "type": "string"
        },
        "identifier_type": {
            "type": "string",
            "enum": [
                "siren",
                "siret"
            ]
        },
        "siren": {
            "type": "string"
        },
        "exists": {
            "type": "boolean"
        },
        "cursor": {
            "type": "string"
        },
        "next_cursor": {
            "type": [
                "string",
                "null"
            ]
        },
        "limit": {
            "type": "integer"
        },
        "total_count": {
            "type": "integer"
        },
        "returned_count": {
            "type": "integer"
        },
        "truncated": {
            "type": "boolean"
        },
        "establishments": {
            "type": "array",
            "items": {
                "type": "object",
                "properties": {
                    "siret": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "status": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "enum": [
                            "active",
                            "closed",
                            null
                        ]
                    },
                    "is_headquarters": {
                        "type": [
                            "boolean",
                            "null"
                        ]
                    },
                    "activity_code": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "activity_nomenclature": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "creation_date": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "closure_date": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "employee_band_code": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "employee_band_year": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "is_employer": {
                        "type": [
                            "boolean",
                            "null"
                        ]
                    },
                    "address": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "postal_code": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "city": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "commune_code": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "last_processed_at": {
                        "type": [
                            "string",
                            "null"
                        ]
                    }
                },
                "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
            }
        }
    },
    "required": [
        "identifier",
        "identifier_type",
        "siren",
        "exists",
        "cursor",
        "next_cursor",
        "limit",
        "total_count",
        "returned_count",
        "truncated",
        "establishments"
    ],
    "additionalProperties": false
}