---
title: "Gets availability dates for a single temp candidate"
method: GET
path: "/Entity/TempCandidateAvailabilityDates"
tags: ["Entity"]
---

# Gets availability dates for a single temp candidate

`GET /Entity/TempCandidateAvailabilityDates`

A candidate is available when the IsAvailable property is True. The UnavailabilityDetail property will return null in this instance.

A candidate is unavailable when the IsAvailable property is False. The UnavailabilityDetail property will return additional information about why they are unavailable.

If they are unavailable because they are in an Infinity placement, then the PlacementId property will return a value.

The /Entity/Placement method can be used to get additional information about an Infinity Placement if required.

## Query parameters

- `candidateid` integer, required
- `fromDate` string, date-time, required
- `toDate` string, date-time, nullable

## Response `200`

OK

- CandidateAvailabilityResult[]
  - `Id` integer, required
  - `Start` string, date-time, required
  - `End` string, date-time, required
  - `TimeZoneId` string, required
  - `IsAvailable` boolean, required
  - `UnavailabilityDetail` CandidateUnavailabilityDetail
    - `UnavailabilityReason` UnavailabilityReason, required
      - `IsActive` boolean
      - `Id` integer
      - `Name` string, nullable
      - `Color` Color
        - `R` integer
        - `G` integer
        - `B` integer
        - `A` integer
        - `IsKnownColor` boolean
        - `IsEmpty` boolean
        - `IsNamedColor` boolean
        - `IsSystemColor` boolean
        - `Name` string, nullable
    - `PlacementId` integer, nullable
  - `IsReadOnly` boolean, required
  - `CanDelete` boolean, required

## Other responses

- `400` — BadRequest
- `401` — Unauthorized
- `404` — NotFound

---

[API](https://skmtc.dev/vslcloud/apis/infinity-api.md) · [All operations](https://skmtc.dev/vslcloud/apis/infinity-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/vslcloud/infinity-api/revisions/54661781612a/schema)