> ## Documentation Index
> Fetch the complete documentation index at: https://developers.essal.cloud/llms.txt
> Use this file to discover all available pages before exploring further.

# Review Applicants

> Score, evaluate, and collaborate on candidates in Essal Careers using scorecards and interviewer assignments.

Once applications start arriving, Essal Careers provides tools to evaluate candidates consistently through **scorecards**, assign interviewers, and collaborate on hiring decisions — all available through the API.

## Listing Applications for a Job

```bash theme={null}
GET /v1/careers/jobs/job_01HXYZJOB1/applications?status=active&sort=submitted_at:asc
```

```json theme={null}
{
  "data": [
    {
      "id": "app_01HXYZAPP1",
      "candidate": {
        "id": "cnd_01HXYZ1234",
        "display_name": "Alice Johnson",
        "email": "alice.j@example.com"
      },
      "stage": { "id": "stg_01HXYZ5555", "name": "CV Review" },
      "submitted_at": "2026-07-05T10:30:00Z",
      "score": null
    }
  ]
}
```

## Scorecards

Define a scorecard template for a job to standardise candidate evaluation:

```bash theme={null}
POST /v1/careers/jobs/job_01HXYZJOB1/scorecard-template
{
  "criteria": [
    { "name": "Technical Skills", "weight": 40 },
    { "name": "Communication", "weight": 30 },
    { "name": "Cultural Fit", "weight": 20 },
    { "name": "Problem Solving", "weight": 10 }
  ],
  "rating_scale": { "min": 1, "max": 5 }
}
```

Submit a scorecard for a specific application:

```bash theme={null}
POST /v1/careers/applications/app_01HXYZAPP1/scorecards
{
  "interviewer_id": "usr_01HXYZ5678",
  "ratings": [
    { "criterion": "Technical Skills", "score": 4 },
    { "criterion": "Communication", "score": 5 },
    { "criterion": "Cultural Fit", "score": 4 },
    { "criterion": "Problem Solving", "score": 3 }
  ],
  "recommendation": "strong_yes",
  "notes": "Excellent systems design knowledge. Highly recommended."
}
```

Recommendation values: `strong_yes`, `yes`, `neutral`, `no`, `strong_no`.

## Assigning Interviewers

Assign team members to conduct and score specific interview stages:

```bash theme={null}
POST /v1/careers/applications/app_01HXYZAPP1/interviewers
{
  "stage_id": "stg_01HXYZ6666",
  "interviewer_ids": ["usr_01HXYZ5678", "usr_01HXYZ9012"]
}
```

Assigned interviewers receive a notification and can submit their scorecard independently. The aggregate score is automatically calculated once all scorecards are submitted.

## Candidate Disqualification

```bash theme={null}
POST /v1/careers/applications/app_01HXYZAPP1/disqualify
{
  "reason": "insufficient_experience",
  "notify_candidate": true,
  "notification_template": "standard_rejection"
}
```

<Note>
  Disqualification is reversible. Set `"status": "active"` on the application to reinstate a candidate if circumstances change.
</Note>