Récupération des candidatures

Description

Récupère une liste paginée de candidatures, filtrée par date, source ou localisation, et triée par date.

---

Endpoint

GET https://api.mytalentplug.com/jam/v1/jobapplications

Authentification

• Requise : Oui
• Type : Bearer Authentication
• Exemple d’en-tête :

Authorization: Bearer <token>

---

Requête

Paramètres de query

Nom du paramètre	Type	Requis	Par défaut	Format	Exemple	Description
page	integer	Non	1	≥ 1	1	Numéro de la page
pageSize	integer	Non	25	1–50	10	Nombre d’éléments par page
fromDate	string	Non	—	ISO 8601	2025-01-01T00:00:00Z	Date de début du filtre (inclusif). Les candidatures dont la date est antérieure à cette valeur ne seront pas incluses dans les résultats
toDate	string	Non	—	ISO 8601	2025-01-31T23:59:59Z	Date de fin du filtre (inclusif). Les candidatures dont la date est postérieure à cette valeur ne seront pas incluses dans les résultats
sourceName	string	Non	—	—	Site carrière	Le nom exact ou partiel de la source de la candidature
jobLocation	string	Non	—	—	Paris - 75000	Le nom exact ou partiel de ville de localisation du poste
sortByDate	sbyte	Non	-1	1 ou -1	1	Tri par date : 1 = de la plus ancienne à la plus récente, -1 = de la plus récente à la plus ancienne

---

Réponse

La réponse est au format JSON.

Réponse 200 (succès)

Exemple

{
  "items": [
    {
      "id": "a1b2c3d4-e5f6-7890-abcd-1234567890ef",
      "ownerId": 42,
      "companyId": 99,
      "date": "2025-04-13T10:30:00Z",
      "applicant": {
        "firstName": "Alice",
        "lastName": "Durand",
        "fullname": "Alice Durand",
        "email": "alice@example.com",
        "phoneNumber": "0123456789"
      },
      "jobOffer": {
        "id": "123456",
        "reference": "REF-ABC-123",
        "atsExternalId" : null,
        "jobTitle": "Développeur .NET",
        "jobLocation": "Paris - 75000"
      },
      "source": "Site carrière",
      "sourceId": 3,
      "rating": 5,
      "attachments": [
        {
          "id": "g8d37995-b3c0-4223-9d73-a35ec7d4f447",
          "fileName": "CV.pdf",
          "fileExtension": "pdf",
          "contentType": "application/pdf",
          "type": 1,
          "date": "2025-04-13T16:09:55.665Z"
        }
      ],
      "tags": ["urgent", "prioritaire"],
      "recruitmentStepId": "ddee6677-8899-aabb-ccdd-1234567890ab",
      "status": 1,
      "duplicatesCount": 3,
      "isMultiApplicationDuplicate": false
    }
  ],
  "page": 1,
  "pageSize": 1,
  "totalCount": 80,
  "hasNextPage": true,
  "hasPreviousPage": false
}

Détail des champs

Propriétés de la réponse

Champ	Type	Description
items	array	Liste des candidatures correspondant aux critères de recherche. Chaque élément contient les informations détaillées sur une candidature. Voir items.
page	integer	Numéro de la page actuelle.
pageSize	integer	Nombre d’éléments renvoyés dans la page.
totalCount	integer	Nombre total de candidatures correspondant aux critères.
hasNextPage	boolean	Indique s’il existe une page suivante.
hasPreviousPage	boolean	Indique s’il existe une page précédente.

Schéma items

Champ	Type	Description
id	string (UUID)	Identifiant unique de la candidature.
ownerId	integer	Identifiant de l'utilisateur qui a créé ou qui gère la candidature.
companyId	integer	Identifiant de l’entreprise associée à la candidature.
date	string (ISO 8601)	Date de réception de la candidature.
applicant	object	Informations sur le candidat. Voir applicant.
jobOffer	object	Informations sur l’offre d’emploi concernée. Voir joboffer.
source	string	Nom de la source de la candidature.
sourceId	integer	Identifiant de la source.
rating	integer	Note ou évaluation de la candidature (0 à 5).
attachments	array	Liste des fichiers joints à la candidature. Voir attachments.
tags	array de strings	Liste de mots-clés associés à la candidature.
recruitmentStepId	string (UUID)	Identifiant de l’étape de recrutement actuelle.
status	integer	Statut de la candidature (0 : non lue, 1 : réouverte, 2 : ouverte, 3 : retenue, 4 : non retenue, 5 : redirigée).
duplicatesCount	integer	Nombre de doublons détectés pour cette candidature.
isMultiApplicationDuplicate	boolean	Indique si le candidat a postulé plusieurs fois au même poste.

Schéma applicant

Champ	Type	Description
firstName	string	Prénom du candidat.
lastName	string	Nom de famille du candidat.
fullname	string	Nom complet du candidat.
email	string	Adresse e-mail du candidat.
phoneNumber	string	Numéro de téléphone du candidat.

Schéma jobOffer

Champ	Type	Description
id	string	Identifiant de l’offre d’emploi.
reference	string	Référence de l’offre d’emploi.
atsExternalId	string	Identifiant de l’offre d’emploi fourni par l'ATS.
jobTitle	string	Intitulé du poste proposé.
jobLocation	string	Localisation du poste (ex. : ville - code postal).

Schéma attachments

Champ	Type	Description
id	string (UUID)	Identifiant unique du fichier.
fileName	string	Nom du fichier.
fileExtension	string	Extension du fichier (ex. : pdf).
contentType	string	Type MIME du fichier (ex. : application/pdf).
type	integer	Type du document (0 pour une pièce jointe, 1 pour le message originel du candidat).
date	string (ISO 8601)	Date de dépôt du fichier.

Réponses d’erreur

Code HTTP	Message	Description
400	Bad Request	Paramètre invalide (ex : sortByDate différent de 1 ou -1)
401	Unauthorized	Jeton d’accès manquant ou invalide
403	Forbidden	Accès refusé
429	Too Many Requests	Trop de requêtes en un temps donné
500	Internal Server Error	Le serveur a rencontré un problème inattendu

Exemple

{
    "type": "https://tools.ietf.org/html/rfc9110#section-15.5.1",
    "title": "Bad Request",
    "status": 400,
    "detail": "Validation failed: \n -- PageSize: must be between 1 and 50 Severity: Error",
    "traceId": "0HNB7RMJ268SM:00000003",
    "requestId": "00-19aae3969015288f7162ad681f003a16-af9a7edd53036350-00"
}

---

Exemple de requête avec curl

curl -X GET 'https://api.mytalentplug.com/jam/v1/jobapplications?page=1&pageSize=10&fromDate=2024-01-01T00:00:00Z&toDate=2024-12-31T23:59:59Z&jobLocation=Paris&sortByDate=1' \
-H 'Authorization: Bearer <token>'