API Retour à l'emploi suite formation v1

Présentation

Cette API restitue le taux de retour à l'emploi pour les demandeurs d'emploi sortants de formation depuis janvier 2013.

Il mesure la part des stagiaires inscrits à Pôle emploi qui, dans les six mois suivant la fin d'une formation, ont :

  • retrouvé un emploi salarié de un mois et plus (hors particuliers employeurs, employeurs publics, employeurs à l'étranger et missions d'intérim à durée non renseignée),
  • ou bénéficié d'un contrat aidé,
  • ou créé leur entreprise.

L’API retourne cinq valeurs possibles :

  • 0.2
  • 0.4
  • 0.6
  • 0.8
  • 1

Ces valeurs correspondent à une répartition par quintile des formations selon leur niveau de retour à l’emploi.
Ainsi :

  • la valeur 0.2 indique que la formation fait partie des 20 % de formations ayant les taux de retour à l’emploi les plus faibles
  • la valeur 1 indique que la formation fait partie des 20 % de formations ayant les taux de retours à l’emploi les plus élevés

Le taux de retour à l'emploi se décline en quatre mailles géographiques : bassin d'emploi, départementale, régionale et nationale.

Les secteurs de formation comptant moins de soixante sortants au niveau national sont exclus des résultats. De plus, les résultats au niveau des mailles géographique ne sont donnés que pour les secteurs de formation comptant plus de 60 sortants au niveau de la maille.

 

Caractéristiques

Mode d'accès public
Fréquence de mise à jour une fois par mois
Cinématique OAuth client credentials grant
Royaume Pôle Emploi Access Management /partenaire
Scopes nécessaires

 

Description de la requête

Point d'accès

GET https://api.emploi-store.fr/partenaire/retouralemploisuiteformation/v1/rank

 

Paramètres d'entrée

Code Cardinalité Format Description
formacode

1,1

String

Numéro unique d’identification des domaines de formation

Référentiel : Formation de Centre Inffo

codeinseeville

1,1

String

Code INSEE de la commune

Si ce paramètre n'est pas renseigné, il est nécessaire d'indiquer la latitude et la longitude.

Référentiel : Géographie administrative de l'Insee

 

Exemple d'appel

GET https://api.emploi-store.fr/partenaire/retouralemploisuiteformation/v1/rank?formacode=22435&codeinseeville=85191

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 vers le site La Bonne Formation.

 

Données retournées

Code Cardinalité Format Description
formacode 1,1 String

Numéro unique d’identification des domaines de formation

Référentiel : Formation de Centre Inffo

codeinsee-bassin 1,1 String

Code INSEE du bassin

Référentiel : Géographie administrative de l'Insee

taux-bassin 1,1 Double

Taux de retour à l'embauche sur le bassin d'emploi de la ville ciblée dans le formacode indiqué

Valeur entre 0 et 1, vide si moins de 60 répondants pour le croisement formacode/bassin

taux-departemental 1,1 Double

Taux de retour à l'embauche au niveau du département de la ville ciblée dans le formacode indiqué

Valeur entre 0 et 1, vide si moins de 60 répondants pour le croisement formacode/département

taux-regional 1,1 Double

Taux de retour à l'embauche au niveau de la région de la ville ciblée dans le formacode indiqué

Valeur entre 0 et 1, vide si moins de 60 répondants pour le croisement formacode/région

taux-national 1,1 Double

Taux de retour à l'embauche au niveau national dans le formacode indiqué

Valeur entre 0 et 1

 

Exemple de retour

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

[
  {
    "formacode": "22435",
    "codeinsee-bassin": "52114",
    "taux-bassin": "",
    "taux-departemental": "",
    "taux-regional": "0.4",
    "taux-national": "0.6"
  }
]

 

Cas d'erreurs possibles

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