---
title: "Get details of a candidate"
method: GET
path: "/candidates/{id}"
tags: ["candidates"]
---

# Get details of a candidate

`GET /candidates/{id}`

Get details of a candidate

## Response `200`

Candidate details

- CandidateDetails
  - `id` string
  - `internal` boolean
  - `firstName` string
  - `lastName` string
  - `email` string
  - `phoneNumber` string
  - `location` CandidateLocation
    - `country` string
    - `countryCode` string
    - `regionCode` string
    - `region` string
    - `city` string
    - `lat` number, float
    - `lng` number, float
  - `web` WebProfile
    - `skype` string
    - `linkedin` string
    - `facebook` string
    - `twitter` string
    - `website` string
  - `createdOn` string, date-time
  - `updatedOn` string, date-time
  - `tags` string[]
  - `averageRating` number
  - `education` Education[]
    - `institution` string
    - `degree` string
    - `major` string
    - `current` boolean
    - `location` string
    - `startDate` string, when — date in YYYY, YYYY-MM or YYYY-MM-dd format, ex. "2016", "2016-11", "2016-11-29"
    - `endDate` string, when — date in YYYY, YYYY-MM or YYYY-MM-dd format, ex. "2016", "2016-11", "2016-11-29"
    - `description` string
  - `experience` Experience[]
    - `title` string
    - `company` string
    - `current` boolean
    - `startDate` string, when — date in YYYY, YYYY-MM or YYYY-MM-dd format, ex. "2016", "2016-11", "2016-11-29"
    - `endDate` string, when — date in YYYY, YYYY-MM or YYYY-MM-dd format, ex. "2016", "2016-11", "2016-11-29"
    - `location` string
    - `description` string
  - `primaryAssignment` union
    - object — Its latest modified application from applications in non final-state. If no applications in non-final state then one in final state with most recent modification date is returned. Inactive(final) states are Lead, Rejected, Transferred, Withdrawn, Hired
      - `id` string, uuid, required
      - `title` string, required
      - `refNumber` string
      - `createdOn` string, date-time
      - `updatedOn` string, date-time — Job modification date
      - `lastActivityOn` string, date-time — Indicates last activity associated with a job
      - `department` Department
        - `id` string
        - `label` string, required
        - `description` string
      - `location` Location — regionCode is not recommended to be used for countries other than the United States.
        - `country` string
        - `countryCode` string, required
        - `regionCode` string
        - `region` string
        - `city` string, required
        - `address` string, address
        - `postalCode` string
        - `longitude` string
        - `latitude` string
      - `status` 'CREATED' | 'SOURCING' | 'FILLED' | 'INTERVIEW' | 'OFFER' | 'CANCELLED' | 'ON_HOLD' | 'OTHER'
      - `postingStatus` 'PUBLIC' | 'INTERNAL' | 'NOT_PUBLISHED' | 'PRIVATE'
      - `type` string, required
      - `description` string, required
      - `isFileUploadRequired` boolean, required
      - `hasSensitiveData` boolean, required
      - `isHighPriority` boolean, required
      - `integrationKey` string
    - object — Its latest modified application from applications in non final-state. If no applications in non-final state then one in final state with most recent modification date is returned. Inactive(final) states are Lead, Rejected, Transferred, Withdrawn, Hired
      - `id` string, uuid, required
      - `title` string, required
      - `refNumber` string
      - `createdOn` string, date-time
      - `updatedOn` string, date-time — Job modification date
      - `lastActivityOn` string, date-time — Indicates last activity associated with a job
      - `department` Department
        - `id` string
        - `label` string, required
        - `description` string
      - `location` Location — regionCode is not recommended to be used for countries other than the United States.
        - `country` string
        - `countryCode` string, required
        - `regionCode` string
        - `region` string
        - `city` string, required
        - `address` string, address
        - `postalCode` string
        - `longitude` string
        - `latitude` string
      - `status` 'CREATED' | 'SOURCING' | 'FILLED' | 'INTERVIEW' | 'OFFER' | 'CANCELLED' | 'ON_HOLD' | 'OTHER'
      - `postingStatus` 'PUBLIC' | 'INTERNAL' | 'NOT_PUBLISHED' | 'PRIVATE'
      - `type` string, required
      - `description` string, required
      - `hasSensitiveData` boolean, required
      - `isHighPriority` boolean, required
      - `integrationKey` string
    - object — Its latest modified application from applications in non final-state. If no applications in non-final state then one in final state with most recent modification date is returned. Inactive(final) states are Lead, Rejected, Transferred, Withdrawn, Hired
      - `id` string, uuid, required
      - `title` string, required
      - `refNumber` string
      - `createdOn` string, date-time
      - `updatedOn` string, date-time — Job modification date
      - `lastActivityOn` string, date-time — Indicates last activity associated with a job
      - `department` Department
        - `id` string
        - `label` string, required
        - `description` string
      - `location` Location — regionCode is not recommended to be used for countries other than the United States.
        - `country` string
        - `countryCode` string, required
        - `regionCode` string
        - `region` string
        - `city` string, required
        - `address` string, address
        - `postalCode` string
        - `longitude` string
        - `latitude` string
      - `status` 'CREATED' | 'SOURCING' | 'FILLED' | 'INTERVIEW' | 'OFFER' | 'CANCELLED' | 'ON_HOLD' | 'OTHER'
      - `postingStatus` 'PUBLIC' | 'INTERNAL' | 'NOT_PUBLISHED' | 'PRIVATE'
      - `type` string, required
      - `description` string, required
      - `hasSensitiveData` boolean, required
      - `isHighPriority` boolean, required
      - `fileName` string, required
      - `integrationKey` string
  - `secondaryAssignments` union[] — List of assignemnts (applications). Applications are sorted by state (non-final states first) and then by date. First one is excluded and is returned as primaryAssignment. Mentioned date is a date of last modification of an application eg: changed state, change of a source, reapply, anonymisation, unshare. Inactive(final) states are Lead, Rejected, Transferred, Withdrawn, Hired
    - union
      - object
        - `id` string, uuid, required
        - `title` string, required
        - `refNumber` string
        - `createdOn` string, date-time
        - `updatedOn` string, date-time — Job modification date
        - `lastActivityOn` string, date-time — Indicates last activity associated with a job
        - `department` Department
          - `id` string
          - `label` string, required
          - `description` string
        - `location` Location — regionCode is not recommended to be used for countries other than the United States.
          - `country` string
          - `countryCode` string, required
          - `regionCode` string
          - `region` string
          - `city` string, required
          - `address` string, address
          - `postalCode` string
          - `longitude` string
          - `latitude` string
        - `status` 'CREATED' | 'SOURCING' | 'FILLED' | 'INTERVIEW' | 'OFFER' | 'CANCELLED' | 'ON_HOLD' | 'OTHER'
        - `postingStatus` 'PUBLIC' | 'INTERNAL' | 'NOT_PUBLISHED' | 'PRIVATE'
        - `type` string, required
        - `description` string, required
        - `isFileUploadRequired` boolean, required
        - `hasSensitiveData` boolean, required
        - `isHighPriority` boolean, required
        - `integrationKey` string
      - object
        - `id` string, uuid, required
        - `title` string, required
        - `refNumber` string
        - `createdOn` string, date-time
        - `updatedOn` string, date-time — Job modification date
        - `lastActivityOn` string, date-time — Indicates last activity associated with a job
        - `department` Department
          - `id` string
          - `label` string, required
          - `description` string
        - `location` Location — regionCode is not recommended to be used for countries other than the United States.
          - `country` string
          - `countryCode` string, required
          - `regionCode` string
          - `region` string
          - `city` string, required
          - `address` string, address
          - `postalCode` string
          - `longitude` string
          - `latitude` string
        - `status` 'CREATED' | 'SOURCING' | 'FILLED' | 'INTERVIEW' | 'OFFER' | 'CANCELLED' | 'ON_HOLD' | 'OTHER'
        - `postingStatus` 'PUBLIC' | 'INTERNAL' | 'NOT_PUBLISHED' | 'PRIVATE'
        - `type` string, required
        - `description` string, required
        - `hasSensitiveData` boolean, required
        - `isHighPriority` boolean, required
        - `integrationKey` string
      - object
        - `id` string, uuid, required
        - `title` string, required
        - `refNumber` string
        - `createdOn` string, date-time
        - `updatedOn` string, date-time — Job modification date
        - `lastActivityOn` string, date-time — Indicates last activity associated with a job
        - `department` Department
          - `id` string
          - `label` string, required
          - `description` string
        - `location` Location — regionCode is not recommended to be used for countries other than the United States.
          - `country` string
          - `countryCode` string, required
          - `regionCode` string
          - `region` string
          - `city` string, required
          - `address` string, address
          - `postalCode` string
          - `longitude` string
          - `latitude` string
        - `status` 'CREATED' | 'SOURCING' | 'FILLED' | 'INTERVIEW' | 'OFFER' | 'CANCELLED' | 'ON_HOLD' | 'OTHER'
        - `postingStatus` 'PUBLIC' | 'INTERNAL' | 'NOT_PUBLISHED' | 'PRIVATE'
        - `type` string, required
        - `description` string, required
        - `hasSensitiveData` boolean, required
        - `isHighPriority` boolean, required
        - `fileName` string, required
        - `integrationKey` string
  - `actions` object
    - `properties` Action, required
      - `url` string, required
      - `method` 'GET' | 'POST' | 'PUT' | 'PATCH' | 'OPTIONS' | 'DELETE' | 'HEAD' | 'CONNECT', required
    - `attachments` Action
      - `url` string, required
      - `method` 'GET' | 'POST' | 'PUT' | 'PATCH' | 'OPTIONS' | 'DELETE' | 'HEAD' | 'CONNECT', required
    - `consent` Action
      - `url` string, required
      - `method` 'GET' | 'POST' | 'PUT' | 'PATCH' | 'OPTIONS' | 'DELETE' | 'HEAD' | 'CONNECT', required
    - `consents` Action
      - `url` string, required
      - `method` 'GET' | 'POST' | 'PUT' | 'PATCH' | 'OPTIONS' | 'DELETE' | 'HEAD' | 'CONNECT', required

## Other responses

- `401` — Candidate access denied

---

[API](https://skmtc.net/smartrecruiters/apis/apply-api.md) · [All operations](https://skmtc.net/smartrecruiters/apis/apply-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/smartrecruiters/apply-api/versions/449bdc2516c9/schema)