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

# Get Screenings for Candidate

> Retrieve all screenings for a specific candidate

Retrieve all screening results for a given candidate across all jobs they've been screened against.

### Path Parameters

<ParamField path="candidateId" type="integer" required>
  ID of the candidate to get screenings for
</ParamField>

### Query Parameters

<ParamField query="status" type="string">
  Filter by screening status (e.g., "qualified", "disqualified")
</ParamField>

<ParamField query="jobId" type="integer">
  Filter by specific job ID
</ParamField>

<ParamField query="limit" type="integer" default="50">
  Maximum number of screenings to return
</ParamField>

<ParamField query="offset" type="integer" default="0">
  Number of screenings to skip for pagination
</ParamField>

### Response Fields

<ResponseField name="screenings" type="array">
  Array of screening results
</ResponseField>

<ResponseField name="total" type="integer">
  Total number of screenings found
</ResponseField>

<ResponseField name="limit" type="integer">
  Maximum number of screenings returned
</ResponseField>

<ResponseField name="offset" type="integer">
  Number of screenings skipped
</ResponseField>

<ResponseExample>
  ```json theme={null}
  {
    "screenings": [
      {
        "id": 789,
        "candidateId": 456,
        "jobId": 123,
        "currentScore": 66.67,
        "potentialScore": 100,
        "disqualify": false,
        "criteria": [
          {
            "id": 1,
            "source": "job_criteria",
            "question": "How many years of ICU nursing experience do you have?",
            "criteria": "Minimum of 3 years ICU nursing experience required",
            "type": "YearsOfExperience",
            "status": "PartiallyMet",
            "reasoning": "The candidate has 2 years of ICU experience...",
            "textEvidence": "2 years of experience in Medical ICU"
          }
        ],
        "qualificationLevel": "Appropriate",
        "isRelevant": true,
        "job": {
          "id": 123,
          "title": "ICU Nurse",
          "location": "San Francisco, CA",
          "department": "Nursing"
        },
        "createdAt": "2024-03-19T18:30:00Z"
      }
    ],
    "total": 5,
    "limit": 50,
    "offset": 0
  }
  ```
</ResponseExample>