Track candidate applications and assessment progress.
The Applications API tracks candidates as they progress through your hiring funnel, from initial application through assessment completion. Use it to monitor application status and trigger workflow actions.
/applications| Name | Type | Required | Description |
|---|---|---|---|
| job_id | string | Optional | Filter by job ID |
| candidate_id | string | Optional | Filter by candidate ID |
| status | string | Optional | Filter by status: applied, invited, in_progress, completed, rejected |
{
"data": [
{
"id": "app_pqr678",
"job_id": "job_mno345",
"candidate_id": "cand_xyz789",
"status": "completed",
"applied_at": "2024-02-10T14:30:00Z",
"invited_at": "2024-02-10T15:00:00Z",
"completed_at": "2024-02-12T09:15:00Z",
"result_id": "result_ghi789",
"score": 87.5
}
],
"pagination": { "total": 203, "limit": 20, "has_more": true }
}/applications/{application_id}{
"id": "app_pqr678",
"job_id": "job_mno345",
"job_title": "Senior Backend Engineer",
"candidate_id": "cand_xyz789",
"candidate_name": "Jane Smith",
"status": "completed",
"timeline": [
{ "event": "applied", "timestamp": "2024-02-10T14:30:00Z" },
{ "event": "invited", "timestamp": "2024-02-10T15:00:00Z" },
{ "event": "exam_started", "timestamp": "2024-02-12T08:15:00Z" },
{ "event": "exam_completed", "timestamp": "2024-02-12T09:15:00Z" }
],
"result": {
"score": 87.5,
"percentile": 82,
"status": "passed"
}
}/applications| Name | Type | Required | Description |
|---|---|---|---|
| job_id | string | Required | Job ID candidate is applying to |
| candidate_id | string | Optional | Existing candidate ID (creates new if omitted) |
| candidate_email | string | Optional | Candidate email (required if candidate_id not provided) |
| auto_invite | boolean | Optional | Automatically send exam invitation (default: false) |
/applications/{application_id}Applications automatically transition through statuses as candidates progress. Manual status updates are tracked in the timeline for audit purposes.
Was this article helpful?