API Expériences professionnelles v1

Présentation

Cette API vous permet d’accéder aux expériences saisies par un individu dans son profil de compétences sur pole emploi.fr : fonction, nom de l’entreprise, périodes de travail etc. Ces données sont également utilisées pour le système de rapprochement entre les  CV et les offres sur pôle emploi.fr.

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

 

Ressources exposées

Cette ressource permet de récupérer la liste des expériences saisies dans son profil de compétences par un individu

 

Description de la requête

Point d'accès

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

 

Exemple d'appel

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

Authorization: Bearer [Access token]

 

Description de la réponse

Données retournées

Code Cardinalité Format Description
date 0,1 Sous-balise

Dates de l'expérience si elles sont renseignées.

Si l'expérience correspond à l'activité actuelle, alors seule la date de début est renseignée (le champ "enPoste" est valorisé à true dans ce cas là).

Si l'expérience est terminée alors une date de fin est renseignée.

date.debut 0,1 DateTime

Date de début de l'expérience

Exemple : 2014-01-01T00:00:00+01:00

date.fin 0,1 DateTime

Date de fin de l'expérience

Exemple : 2017-02-01T00:00:00+01:00

description 0,1 String

Description de l'expérience si elle est renseignée.

duree 0,1 Long

Durée exprimée en nombre de mois de l'expérience si elle est renseignée.

enPoste 1 Boolean

Booléen indiquant si l'expérience est toujours en cours.

Remarque : un individu peut avoir plusieurs expériences en cours

entreprise 0,1 String Nom de l'entreprise s'il est renseigné
etranger 1 Boolean

Booléen indiquant si l'expérience s'est déroulée en France ou à l'étranger

  • false = expérience en France
  • true = expérience à l'étranger
intitule 1 String Intitulé de l'expérience renseigné par l'individu dans son profil de compétences dans l'onglet "parcours".
lieu 0,1 String Lieux de l'expérience s'il est renseigné

 

Exemple de retour

HTTP 200 OK
Content-Type: application/json
Cache-Control: no-cache
[
    {
        "date": {
            "debut": "2018-02-01T00:00:00+01:00"
        },
        "description": "service de 150 couverts, encadrement d’une équipe de 5 personnes, augmentation de 5% du chiffre d’affaires",
        "duree": 5,
        "enPoste": true,
        "entreprise": "Hippopotamus",
        "etranger": false,
        "intitule": "serveur",
        "lieu": "Nantes"
    },
    {
        "date": {
            "debut": "2011-06-01T00:00:00+02:00"
        },
        "duree": 85,
        "enPoste": true,
        "etranger": false,
        "intitule": "Engagement associatif"
    },
    {
        "date": {
            "debut": "2014-01-01T00:00:00+01:00",
            "fin": "2015-01-01T00:00:00+01:00"
        },
        "description": "travail sur les chantiers",
        "duree": 13,
        "enPoste": false,
        "entreprise": "LABEYRIE",
        "etranger": false,
        "intitule": "Ouvrier spécialisé et manoeuvre",
        "lieu": "paris"
    }
]

 

Cas d'erreurs possibles

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