---
title: "Get availability"
method: GET
path: "/candidates/{candidateId}/availability"
tags: ["Candidate API:Availability"]
---

# Get availability

`GET /candidates/{candidateId}/availability`

## Path parameters

- `candidateId` integer, required

## Response `200`

Availability for the specified candidate

- CandidateAvailabilityListRepresentation
  - `items` CandidateAvailabilityModel[], nullable
    - `date` string, date — Date available ([ISO full-date](https://www.rfc-editor.org/rfc/rfc3339.html#section-5.6))
    - `day` 'Sunday' | 'Monday' | 'Tuesday' | 'Wednesday' | 'Thursday' | 'Friday' | 'Saturday', string
    - `shifts` TimeRangeModel[], nullable — Time available, at least one and at most two shifts
      - `start` string, time — Start time of day interval ([ISO partial-time](https://www.rfc-editor.org/rfc/rfc3339.html#section-5.6))
      - `end` string, time — End time of day interval ([ISO partial-time](https://www.rfc-editor.org/rfc/rfc3339.html#section-5.6))
    - `recurring` boolean — Availability is repeated in following weeks
    - `until` string, date, nullable — Optional end date of repeating availability
  - `links` ModelLinks
    - `self` string, uri, nullable

---

[API](https://skmtc.net/jobadder/apis/jobadder-api.md) · [All operations](https://skmtc.net/jobadder/apis/jobadder-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/jobadder/jobadder-api/revisions/9f43f6a6ee6e/schema)