Récupérer le détail d'un organisme formateur

Présentation

Cette ressource permet de récupérer les informations d’un organisme formateur à partir de son identifiant (SIRET).

 

Description de la requête

Point d'accès

GET https://api.emploi-store.fr/partenaire/anotea/v1/organismes-formateurs/{siret}

 

Paramètres d'entrée

Code Cardinalité Format Description
siret 1 String Le numéro SIRET de l’organisme de formation

 

Exemple d'appel

GET https://api.emploi-store.fr/partenaire/anotea/v1/organismes-formateurs/11111111111111

Authorization: Bearer [Access token]

 

Description de la réponse

Lors de la réponse de l'API, une redirection (code HTTP 302 Found) est réalisée du domaine https://api.emploi-store.fr/api/anotea/v1/organismes-formateurs/{siret} vers le domaine https://anotea.pole-emploi.fr/api/v1/organismes-formateurs/{siret}.

Vous devez explicitement indiquer à votre client HTTP de suivre les redirections car il ne le fait probablement pas par défaut. Par exemple pour le client curl, il est nécéssaire d'utiliser curl --location (ou curl -L).

 

Données retournées

Code Cardinalité Format Description
id 1 String Identifiant de l'organisme formateur
numero 1 String Numéro de l'organisme formateur
siret 0..1 String SIRET de l'organisme formateur
raison_sociale 1 Date

 Raison sociale de l'organisme formateur

lieux_de_formation 0..n Tableau Lieux de formations de l'organisme formateur
lieux_de_formation.nom 0..1 Sring Nom du lieu de formation
lieux_de_formation.adresse 0..1 Tableau Adresse du lieu de formation
lieux_de_formation.code_postal 0..1 String Code postal du lieu de formation
lieux_de_formation.ville 0..1 String Ville du lieu de formation
lieux_de_formation.region 0..1 String

Région du lieu de formation

Liste des régions - Documentation INSEE

score 1 Sous-balise Liste des notes
score.nb_avis 1 Integer Nombre d'avis
score.notes 0..1 Sous-balise Notes
score.notes.accueil 0..1 Integer 1 Moyenne des notes sur l'accueil (sur 5)
score.notes.contenu_formation 0..1 Integer 1 Moyenne des notes sur le contenu (sur 5)
score.notes.equipe_formateurs 0..1 Integer 1 Moyenne des notes sur l'équipe de formateurs (sur 5)
score.notes.moyen_materiel 0..1 Integer 1 Moyenne des notes sur les moyens matériels (sur 5)
score.notes.accompagnement 0..1 Integer 1 Moyenne des notes sur l'accompagnement (sur 5)
score.notes.global 0..1 Integer 1 Moyenne des notes globales (sur 5)

 

Exemple de retour

HTTP 200 OK
Content-Type: application/json;charset=UTF-8
Cache-Control: no-store
Pragma: no-cache

{
  "id": "string",
  "siret": "string",
  "numero": "string",
  "raison_sociale": "string",
  "lieux_de_formation": [
    {
      "nom": "string"
      "adresse": {
        "code_postal": "string",
        "ville": "string",
        "region": "string"
      }
    }
  ],
  "score": {
    "nb_avis": 0,
    "notes": {
      "accueil": 0,
      "contenu_formation": 0,
      "equipe_formateurs": 0,
      "moyen_materiel": 0,
      "accompagnement": 0,
      "global": 0
    }
  }
}

 

Cas d'erreurs possibles

Retrouvez la liste des cas d'erreurs possibles sur la page Erreurs Types.

Syntaxe de la requête erronnée :

HTTP 400 Bad request
Content-Type: application/json
Cache-Control: no-store
Pragma: no-cache

{
    "statusCode": 400,
    "error": "Bad Request",
    "message": "Identifiant invalide"
}