API Statut v1

Présentation

L’API Statut permet de déterminer si l'utilisateur connecté à votre application est un demandeur d'emploi ou non.

L'utilisateur doit au préalable s'être identifié sur votre application avec son compte Pôle emploi  grâce à l'API Se connecter avec Pôle emploi.

 

Caractéristiques

Mode d'accès restreint (demande d'accès soumise à validation de Pôle emploi)
Fréquence de mise à jour temps réél
Cinématique OAuth authorization code flow
Royaume Pôle Emploi Access Management /individu
Scopes nécessaires

 

Description de la requête

Point d'accès

GET https://api.emploi-store.fr/partenaire/peconnect-statut/v1/statut

 

Exemple d'appel

GET https://api.emploi-store.fr/partenaire/peconnect-statut/v1/statut

Authorization: Bearer [Access token]

 

Description de la réponse

Données retournées

Code Cardinalité Format Description
codeStatutIndividu 1,1 String 1

Code du statut de l'individu

Valeurs possibles (code → libellé) :

  • 0 → Non demandeur d'emploi
  • 1 → Demandeur d'emploi
libelleStatutIndividu 1,1 String 50

Libellé correspondant au statut de l'individu

 

Exemple de retour

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

{
  "codeStatutIndividu": "0",
  "libelleStatutIndividu": "Non demandeur d'emploi"
}

 

Cas d'erreurs possibles

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