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": 2,
"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 (Valeur possible dans "Type de pièce jointe" ci-dessous). |
date | string (ISO 8601) | Date de dépôt du fichier. |
Type de pièce jointe
| Code | Libelle | Description |
|---|---|---|
0 | Untyped | Type de document non identifié |
1 | Message | Message associé à la candidature |
2 | Resume | Curriculum vitae |
3 | CoverLetter | Lettre de motivation |
4 | Archive | Archive (format compressé) |
5 | Other | Autre type de document |
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 | Limite d'appels dépassée (voir Limites d'appels) |
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>'