POST/cpro/structures/v1/rechercher

Rechercher Structure par SIRET

Rechercher une structure en utilisant son numéro SIRET ou d'autres identifiants. ⚠️ Deux pièges vérifiés sur l'API de production (spec V5.01) : 1) la réponse ne contient JAMAIS de champ typeStructure — il n'existe qu'en critère d'ENTRÉE facultatif. Pour savoir si un SIRET est public ou privé, recherchez AVEC structure.typeStructure = « PUBLIQUE » : trouvé signifie public ; introuvable alors qu'une recherche sans filtre le trouve signifie privé. 2) Les structures privées ne sont renvoyées que si elles sont rattachées à votre compte technique ; tout autre SIRET privé renvoie codeRetour 20000 / GDP_MSG_11.048, exactement comme un SIRET inexistant (jamais de 404 HTTP).

Marre de gérer PISTE, les certificats et le XML ? Chorus Pay gère tout le flux à votre place - devis accepté, bon de commande, facture déposée sur Chorus Pro.Découvrir Chorus Pay →·Comparer les deux approches

Authentification multiple requise

TOUTES REQUISES

Ce point de terminaison nécessite toutes les méthodes d'authentification suivantes :

Token Bearer

OAuth2 Bearer token

En-tête personnalisé

Chorus Pro account credentials

En-tête requis

cpro-account: base64(login:password)
Comment s'authentifier

Incluez votre token Bearer dans l'en-tête Authorization :

Authorization: Bearer YOUR_API_TOKEN

Vous pouvez obtenir votre token API depuis votre tableau de bord.

Comment s'authentifier

Incluez l'en-tête personnalisé dans votre requête :

cpro-account: base64(login:password)

Paramètres du corps

ParamètreRequisDescription
structure.typeIdentifiantStructure
Type: string
RequisType of identifier (e.g., SIRET, SIREN).
structure.identifiantStructure
Type: string
RequisThe structure identifier value.
structure.typeStructure
Type: string
OptionnelOptional 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
OptionnelDefaults to true : private structures are only returned when attached to your technical account. Public structures are always searchable.

Exemple de corps de requête

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

En-têtes

En-têteRequisDescription
Content-Type
RequisContent type of the request
Par défaut: application/json;charset=utf-8
Accept
RequisExpected response content type
Par défaut: application/json;charset=utf-8

Réponses

Loading...
Loading...