Récupérer les candidats

Vous pouvez récupérer les candidats grâce à l'API.

Requête

Cette méthode permet de rechercher un (ou plusieurs) candidats :

POST /company/{companyID}/search/applicants

Paramètres

Paramètre	In	Type	Obligatoire	Description	Exemple
companyId	path	string	✔️	Identifiant de l'entreprise	Wy3EOp2NP3p1KMq8
firstname	query	string		firstname du candidat	John
lastname	query	string		lastname du candidat	Doe
email	query	string		email du candidat	john.doe@mail.fr
hired	query	boolean		Le candidat est-il recruté ou non ?	true
column	query	string		title de la colonne dans laquelle se trouve le candidat	Entretien RH
start	query	string		Date au format MM/JJ/AA pour rechercher les candidats créés à partir d'une date donnée	11/15/22
end	query	string		Date au format MM/JJ/AA pour rechercher les candidats créés avant une date donnée"	12/25/22
company	query	string		Permet de rechercher sur plusieurs entreprises pour les multicomptes
vacancy	query	string		id de l'offre dans laquelle se trouve le candidat	k5aMxpQoK7nGZ2Oz

Exemples de requête

Nom

Requête cURL

curl -X POST https://api.flatchr.io/company/Wy3EOp2NP3p1KMq8/search/applicants
    -H "Authorization: Bearer {token}"
    -H 'Content-Type: application/json'
    -d '{"lastname":"{nom}"}'

Email

Requête cURL

curl -X POST https://api.flatchr.io/company/Wy3EOp2NP3p1KMq8/search/applicants
    -H "Authorization: Bearer {token}"
    -H 'Content-Type: application/json'
    -d '{"email":"{mail@mail.com}"}'

Recruté

Requête cURL

curl -X POST https://api.flatchr.io/company/Wy3EOp2NP3p1KMq8/search/applicants
    -H "Authorization: Bearer {token}"
    -H 'Content-Type: application/json'
    -d '{"hired":"true"}'

Depuis le 25/12/2021

Requête cURL

curl -X POST https://api.flatchr.io/company/Wy3EOp2NP3p1KMq8/search/applicants
    -H "Authorization: Bearer {token}"
    -H 'Content-Type: application/json'
    -d '{"start":"12/25/21"}'

Entre le 01/01/2022 et le 10/01/2022

Requête cURL

curl -X POST https://api.flatchr.io/company/Wy3EOp2NP3p1KMq8/search/applicants
    -H "Authorization: Bearer {token}"
    -H 'Content-Type: application/json'
    -d '{"start":"01/01/22", "end":"01/10/22"}'

Multicomptes

Requête cURL

curl -X POST https://api.flatchr.io/company/Wy3EOp2NP3p1KMq8/search/applicants
    -H "Authorization: Bearer {token}"
    -H 'Content-Type: application/json'
    -d '{"hired":"true","company":"{company}"}'

Réponse

Name	Type	Description
applicant	string	Id du candidat
vacancy	string	Nom de l'offre sur laquelle il a postulé
column	string	Colonne dans laquelle est le candidat
external_id	string	Id externe
firstname	string	Prénom
lastname	string	Nom
email	string	Mail
phone	string	Téléphone
created_at	timestamp	Date de création du candidat (JJ/MM/AA)
source	string	Source de la candidature
status	integer	Statut du candidat (1: Actif, 2: Archivé)

Exemple de réponse

[{
    "applicant": "z7gWQnjXG77hJRak",
    "vacancy": "Ingénieur Développement  H/F ",
    "column": "Recruté",
    "external_id": "",
    "firstname": "XXXXX",
    "lastname": "XXXXX",
    "email": "XXXXX@gmail.com",
    "phone": "+33 6 00 00 00 00",
    "created_at": "09/11/21",
    "source": "L'Apec",
    "status": 1
}]