API Docs
Back to Bulk API

Bulk Matching

Matches many resumes to one or more jobs. Returns an operationId; results are available via the status endpoint when complete.

Sample Request & Response

POST
/v1/bulk/match
Sample Request

Headers:

{
  "Authorization": "Bearer <YOUR_API_KEY>",
  "Content-Type": "application/json"
}

Body:

{
  "resumes": [
    "resume_1",
    "resume_2"
  ],
  "jobs": [
    "job_1",
    "job_2"
  ],
  "topK": 5,
  "include": [
    "highlights"
  ]
}
Sample Response (202)
{
  "operationId": "op_bulk_match_456",
  "status": "queued",
  "accepted": {
    "resumes": 2,
    "jobs": 2
  }
}