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

# Get a candidate

`GET /recruitment/candidates/{id}`

## Response `200`

OK

- object
  - `data` Candidate
    - `id` string, required
    - `full_name` string, required
    - `email` string
    - `phone_numbers` string[]
    - `date_of_birth` string
    - `position` string
    - `urls` string[]
    - `skills` string[]
    - `location` string
    - `created_at` string, date-time
    - `updated_at` string, date-time
    - `gender` string
    - `source` string
    - `level` string
    - `desired_salary` integer
    - `currency_code` string
    - `last_contacted_at` string
    - `cover_letter` string
    - `resume` boolean
    - `resume_url` string, uri
    - `tags` string[]
    - `languages` object[]
      - `id` integer
      - `code` string
      - `level` string
    - `created_by` ReportingTo
      - `id` integer, required
      - `first_name` string
      - `last_name` string
      - `email` string, email, required
    - `applications` object[]
      - `id` integer, required
      - `disqualified_at` string, date-time
      - `vacancy` object
        - `id` integer
        - `title` string
      - `pipeline_state` object
        - `id` integer
        - `name` string
      - `disqualify_reason` object
        - `id` integer
        - `name` string
    - `custom_fields` object[]
      - `candidate_field_id` integer
      - `name` string
      - `internal_name` string
      - `value` union
        - string
        - unknown[]
          - unknown
        - integer
        - boolean
    - `consent` object
      - `status` string
      - `consented_at` string, date-time
      - `rejected_at` string, date-time
      - `expired_at` string, date-time
    - `future_recruitment_consent` object
      - `status` string
      - `consented_at` string, date-time
      - `rejected_at` string, date-time
      - `expired_at` string, date-time

---

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