helpmyagent.com
FR Explore APIs

French Company Profile

Returns the public profile of a French company from a SIREN or SIRET.

POST https://api.helpmyagent.com/v1/company/fr/profile
$ 0.005 $ / callcharged on valid result · empty result not charged · errors not charged
FRCoverageFR
DBDocumented sources1
{ }Structured outputJSON
⌁REST + MCPx402
$Pay per call0.005 $

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 a normalized public administrative profile for a French company from its SIREN or SIRET.
  • You need headquarters, activity, legal-form, creation-date, employee-band or establishment-count fields in one response.

Avoid when

  • You only need a yes/no existence or active-status check; use company/fr/verify.
  • You need directors, financial statements, legal risk or compliance results; use the dedicated endpoint.

Limitations

  • Some profile fields can be null when the public source does not expose them for the company.
  • This endpoint does not replace the specialized directors, financials, risk or compliance endpoints.

Sources and provenance

Sources published for this endpoint are shown directly with their original link.

API Recherche d'entreprises

recherche-entreprises.api.gouv.fr

View source ↗

Stored real response

This snapshot is served from published database data without executing the paid API.

View full JSON →
company/fr/profileStored demo
Request
{
    "identifier": "356000000"
}
Stored response
{
    "identifier": "356000000",
    "identifier_type": "siren",
    "exists": true,
    "siren": "356000000",
    "name": "LA POSTE",
    "status": "active",
    "legal_form_code": "5510",
    "creation_date": "1991-01-01",
    "closure_date": null,
    "activity_code": "53.10Z",
    "company_category": "GE",
    "employee_band_code": "53",
    "employee_band_year": "2023",
    "is_employer": null,
    "establishments_count": 13130,
    "open_establishments_count": 8862,
    "headquarters": {
        "siret": "35600000000048",
        "status": "active",
        "activity_code": "53.10Z",
        "creation_date": "2003-01-01",
        "address": "DIRECTION GENERALE DE LA POSTE 9 RUE DU COLONEL PIERRE AVIA 75015 PARIS",
        "postal_code": "75015",
        "city": "PARIS",
        "department": "75",
        "region": "11",
        "latitude": "48.831515159",
        "longitude": "2.2780898787"
    }
}
Generated : 2026-09-03T15:33:26+00:00
$Billing policy

0.005 $ / call · charged on valid result · empty result not charged · errors not charged.

Input / Output schemas

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

OpenAPI 3.1 →
Input schema
identifierstringRequired · 9-digit SIREN or 14-digit SIRET
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"
        }
    },
    "required": [
        "identifier"
    ],
    "additionalProperties": false
}
Output schema
identifierstringRequired
identifier_typestringRequired
existsbooleanRequired
sirenstring | nullRequired
namestring | nullRequired
statusstring | nullRequired
legal_form_codestring | nullRequired
creation_datestring | nullRequired
closure_datestring | nullRequired
activity_codestring | nullRequired
company_categorystring | nullRequired
employee_band_codestring | nullRequired
employee_band_yearstring | nullRequired
is_employerboolean | nullRequired
establishments_countinteger | nullRequired
open_establishments_countinteger | nullRequired
headquartersobject | nullRequired
View 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"
            ]
        },
        "status": {
            "type": [
                "string",
                "null"
            ]
        },
        "legal_form_code": {
            "type": [
                "string",
                "null"
            ]
        },
        "creation_date": {
            "type": [
                "string",
                "null"
            ]
        },
        "closure_date": {
            "type": [
                "string",
                "null"
            ]
        },
        "activity_code": {
            "type": [
                "string",
                "null"
            ]
        },
        "company_category": {
            "type": [
                "string",
                "null"
            ]
        },
        "employee_band_code": {
            "type": [
                "string",
                "null"
            ]
        },
        "employee_band_year": {
            "type": [
                "string",
                "null"
            ]
        },
        "is_employer": {
            "type": [
                "boolean",
                "null"
            ]
        },
        "establishments_count": {
            "type": [
                "integer",
                "null"
            ]
        },
        "open_establishments_count": {
            "type": [
                "integer",
                "null"
            ]
        },
        "headquarters": {
            "type": [
                "object",
                "null"
            ],
            "properties": {
                "siret": {
                    "type": [
                        "string",
                        "null"
                    ]
                },
                "status": {
                    "type": [
                        "string",
                        "null"
                    ]
                },
                "activity_code": {
                    "type": [
                        "string",
                        "null"
                    ]
                },
                "creation_date": {
                    "type": [
                        "string",
                        "null"
                    ]
                },
                "address": {
                    "type": [
                        "string",
                        "null"
                    ]
                },
                "postal_code": {
                    "type": [
                        "string",
                        "null"
                    ]
                },
                "city": {
                    "type": [
                        "string",
                        "null"
                    ]
                },
                "department": {
                    "type": [
                        "string",
                        "null"
                    ]
                },
                "region": {
                    "type": [
                        "string",
                        "null"
                    ]
                },
                "latitude": {
                    "type": [
                        "string",
                        "null"
                    ]
                },
                "longitude": {
                    "type": [
                        "string",
                        "null"
                    ]
                }
            }
        }
    },
    "required": [
        "identifier",
        "identifier_type",
        "exists",
        "siren",
        "name",
        "status",
        "legal_form_code",
        "creation_date",
        "closure_date",
        "activity_code",
        "company_category",
        "employee_band_code",
        "employee_band_year",
        "is_employer",
        "establishments_count",
        "open_establishments_count",
        "headquarters"
    ],
    "additionalProperties": false
}

Example queries

Queries published with the API to help select the right endpoint.

Give me the public profile of SIREN 356000000.
Where is this French company headquartered and what is its activity code?
How many establishments does this company have?