API
Candidate API
Get Open to Work Batch

Get Candidate's Open To Work Status for multiple candidates in a batch.

This endpoint retrieves "Open To Work" status for multiple candidates in a batch.

Endpoint

POST https://api.ezyhire.com/candidate/getOpenToWorkBatch

Request

Headers
USER-Key: User/API key for authentication
Body:json
[
  {
    "email": "candidate1@example.com",
    "firstName": "Alice",
    "lastName": "Smith",
    "linkedinUrl": "https://www.linkedin.com/in/candidate1profile"
  },
  {
    "email": "candidate2@example.com",
    "firstName": "Bob",
    "lastName": "Johnson",
    "linkedinUrl": "https://www.linkedin.com/in/candidate2profile"
  },
]

Response

Successful Response
Status Code: 200 OK
Content:json
{
 "status": 200,
 "message": "Candidate saved",
 "data": {
   "candidateData": {
     "email": "candidate@example.com",
     "firstName": "John",
     "lastName": "Doe",
     "openToWork": true, 
     "linkedinData": "<LinkedIn profile data>"
   },
   "totalUsages": 5,
   "currentCycleUsages": 2
 }
}
Error Response
Status Code: 401 Unauthorized or 500 Internal Server Error
Content:json
{
  "status": 401,
  "message": "Invalid User/API key",
  "error": "Please provide a valid User/API key"
}