API Expériences déclarées par l’Employeur v1

Présentation

Cette API vous permet de reconstituer la carrière professionnelle d’un individu basée sur les justificatifs employeurs (Attestations employeurs, DSN…) transmis à Pôle emploi : nom de l’employeur, période de travail…

Cette API fait partie du lot d'API mis à disposition dans le cadre du dispositif de portabilité de données personnelles d'un individu (Pôle emploi connect).

Pour pouvoir l'exploiter, 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-experiencesprofessionellesdeclareesparlemployeur/v1/contrats

 

Exemple d'appel

GET https://api.emploi-store.fr/partenaire/peconnect-experiencesprofessionellesdeclareesparlemployeur/v1/contrats?dateDebutPeriode=20170101&dateFinPeriode=20180401

Authorization: Bearer [Access token]

 

Header

Nom donnée

Description Cardinalité

Authorization Bearer

[Valeur de l'access token]

1

Content-Type

application/json

1
Accept

application/json

1

 

Paramètres d'entrée

Nom données Code Cardinalité Format Description
Date de début de la période dateDebutPeriode 1 String 8

Envoyé sous forme de chaine de caractères AAAAMMJJ

La recherche se fait sur tous les contrats ayant été en cours dans la période (qu’ils soient terminés ou non)

Date de fin de la période dateFinPeriode 1 String 8

Envoyé sous forme de chaine de caractères AAAAMMJJ

La recherche se fait sur tous les contrats ayant été en cours dans la période (qu’ils soient terminés ou non)

La période ne peut excéder 24 mois

Nature du contrat natureContrat 0,1 String 21

Envoyé sous forme de chaine de caractères (max 21 caractères)

  • « CDI »
  • « CDD »
  • « CTT » (Intérimaire)
  • « CUI » (Contrats aidés)
  • « Professionnalisation »
  • « Apprentissage »
Durée de travail minimum dureeTravailMin 0,1 String

Attendue sur un ou plusieurs caractères numériques

A renseigner en heures, jours ou mois avec le paramètre "uniteDureeTravail" ci-dessous

Unité de la durée de travail uniteDureeTravail 0,1 Integer

Unité de la durée de contrat

  • Obligatoire si durée renseignée
  • Attendue sur un caractère alphanumérique
    • « m » pour mois
    • « j » pour jours
    • « h » pour heures

Si l’unité est « j » ou « m », la recherche se fait sur la durée du contrat (dates du contrat)

Si l’unité est « h » : la recherche se fait sur la quantité de travail réelle portée par les salaires du contrat dans la limite des 13 derniers mois. En sachant que sur certains contrats, les quantités de travail ne sont pas exprimées en heures (cachets, embarquements, vacations). Ces quantités seront transformées en heures.

 

Description de la réponse

Données retournées

Nom donnée Code Cardinalité Format Description
Date de début de l'activité dateDebut 1 String 8

Envoyé sous forme de chaine de caractères AAAAMMJJ

Date de fin de l'activité dateFin 1 String 8

Envoyé sous forme de chaine de caractères
AAAAMMJJ

Nature du contrat natureContrat 0,1 String 21

Envoyé sous forme de chaine de caractères (max 21 caractères)

  • « CDI »
  • « CDD »
  • « CTT » (Intérimaire)
  • « CUI » (Contrats aidés)
  • « Professionnalisation »
  • « Apprentissage »
Niveau de qualification niveauQualification 0,1 String 9

Envoyé sous forme de chaine de caractères

  • « Cadre »
  • « Non cadre »
Intitulé du poste intitulePoste 0,1 String Envoyé sous forme de chaine de caractères
Quantité de travail quantiteTravail 0,1 Integer

Cumul du temps de travail

Envoyé sur un ou plusieurs caractères numériques

Durée du contrat dureeContrat 0,1 Integer

Durée du contrat

Envoyé sur un ou plusieurs caractères numériques

Entreprise entreprise 0..n Sous balise

Liste des entreprises

Nom de l'entreprise entreprise.nom 1 String

Nom de l'entreprise

SIRET entreprise.siret 1 String 14

Numéro de siret de l'entreprise

Code APE entreprise.codeAPE 1 String 5

Code APE de l'entreprise

Régime entreprise.regime 1 String 12

Régime de l'entreprise

Liste des régimes :

  • Employeur Agricole
  • CAE CA
  • Compagnie Maritime Etrangère
  • Sect.Pub.Adh. avec contrat
  • Sect.Pub.Adh. Conv. de Gestion
  • Sect.Pub.Adh. Irrévocable
  • Employeur Dockers
  • Expat.Affi.facult Entreprise
  • Expat.Adh.Individuelle
  • Expat.Affi.facult.Org.int
  • Expat.Affi.obligatoire
  • Régime Général
  • Aide Régime
  • Aide Tiers
  • Employeur Gens de Maison
  • Employeur du Spectacle
  • Employeur GUSO
  • Employeur VRP Multicarte
Secteur entreprise.secteur 1 String 6

Secteur de l'entreprise

Liste des secteurs :

  • Privé
  • Public

 

Exemple de retour

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

{"contrats": [
  {
     "dateDebut": "20130311",
     "datefin": "20130321",
     "intitulePoste": "Employé de commerce qualifié",
     "natureContrat": "CDD",
     "niveauQualification": "Non cadre",
     "dureeContrat": "11",
     "quantiteTravail": "56",
     "entreprise": {
          "codeApe": "5629B",
          "nom": "CAISSE CENTRALE ACTIVITE SOCIALE",
          "regime": "Régime Général",
          "secteur": "Privé",
          "siret": "77569474807916"
     }

  },

     {

      "dateDebut": "20140401",
      "dateFin": "20161102",
      "intitulePoste": "Métier indéterminé",
      "natureContrat": "CDD",
      "niveauQualification": "Non cadre",
      "dureeContrat": "947",
      "quantiteTravail": "1142",
      "entreprise": {
           "codeApe": "5610B",
           "nom": "JB NIMES",
           "regime": "Régime Général",
           "secteur": "Privé",
           "siret": "81925395600018"
       }
   }
]}

 

Cas d'erreurs possibles

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