Comparable French companies

Finds administratively comparable French companies for later comparison or benchmarking.

0.020 USD

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

When to use this API?

Use for

  • Finds administratively comparable French companies for later comparison or benchmarking.

Avoid when

  • Do not use this endpoint as a legal, regulated credit or guaranteed fraud-free decision unless explicitly stated otherwise.

Limitations

  • Coverage depends on the public sources listed for this endpoint.

Sources and provenance

recherche-entreprises.api.gouv.fr

recherche-entreprises.api.gouv.fr

Input / Output schemas

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

OpenAPI 3.1 →

Input schema
identifierstring

Required

scopestring

limitinteger

View full JSON Schema
{
    "type": "object",
    "properties": {
        "identifier": {
            "type": "string",
            "pattern": "^[0-9]{9}([0-9]{5})?$"
        },
        "scope": {
            "type": "string",
            "enum": [
                "department",
                "region",
                "france"
            ],
            "default": "region"
        },
        "limit": {
            "type": "integer",
            "minimum": 1,
            "maximum": 25,
            "default": 10
        }
    },
    "required": [
        "identifier"
    ],
    "additionalProperties": false
}
Output schema
identifierstring

Required

existsboolean

Required

siren

Required

name

Required

scopestring

Required

criteriaobject

Required

peersarray

Required

limitationsarray

View full JSON Schema
{
    "type": "object",
    "properties": {
        "identifier": {
            "type": "string"
        },
        "exists": {
            "type": "boolean"
        },
        "siren": [],
        "name": [],
        "scope": {
            "type": "string"
        },
        "criteria": {
            "type": "object"
        },
        "peers": {
            "type": "array"
        },
        "limitations": {
            "type": "array"
        }
    },
    "required": [
        "identifier",
        "exists",
        "siren",
        "name",
        "scope",
        "criteria",
        "peers"
    ],
    "additionalProperties": false
}