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	api_peconnect-experiencesprofessionellesdeclareesparlemployeurv1 application_`Votre identifiant client` passeprofessionnel

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.