POST/cpro/structures/v1/rechercher

Search structure by SIRET

Search for a structure using its SIRET number or other identifiers. ⚠️ Two traps verified against the production API (spec V5.01): 1) the response NEVER contains a typeStructure field — it only exists as an optional INPUT filter. To find out whether a SIRET is public or private, search WITH structure.typeStructure = "PUBLIQUE": found means public; not found while an unfiltered search finds it means private. 2) Private structures are only returned when attached to your technical account; any other private SIRET returns codeRetour 20000 / GDP_MSG_11.048, exactly like a SIRET that does not exist (never an HTTP 404).

Tired of dealing with PISTE, certificates and XML? Chorus Pay handles the whole flow for you - quote acceptance, purchase order, invoice deposited on Chorus Pro.Discover Chorus Pay →·Compare both approaches

Multiple Authentication Required

ALL REQUIRED

This endpoint requires all of the following authentication methods:

Bearer Token

OAuth2 Bearer token

Custom Header

Chorus Pro account credentials

Required Header

cpro-account: base64(login:password)
How to authenticate

Include your Bearer token in the Authorization header:

Authorization: Bearer YOUR_API_TOKEN

You can obtain your API token from your account dashboard.

How to authenticate

Include the custom header in your request:

cpro-account: base64(login:password)

Body Parameters

ParameterRequiredDescription
structure.typeIdentifiantStructure
Type: string
RequiredType of identifier (e.g., SIRET, SIREN).
structure.identifiantStructure
Type: string
RequiredThe structure identifier value.
structure.typeStructure
Type: string
OptionalOptional filter: PUBLIQUE or PRIVEE. This is the ONLY way to learn a structure's public/private type from this endpoint — the response never carries it. Search with PUBLIQUE : a match proves the structure is public.
restreindreStructuresPrivees
Type: boolean
OptionalDefaults to true : private structures are only returned when attached to your technical account. Public structures are always searchable.

Example Request Body

{
  "structure": {
    "typeIdentifiantStructure": "SIRET",
    "identifiantStructure": "21210383200011",
    "typeStructure": "PUBLIQUE"
  }
}

Headers

HeaderRequiredDescription
Content-Type
RequiredContent type of the request
Default: application/json;charset=utf-8
Accept
RequiredExpected response content type
Default: application/json;charset=utf-8

Responses

Loading...
Loading...