---
title: "GET /candidates/{id}/"
method: GET
path: "/candidates/{id}/"
tags: ["candidates"]
---

# GET /candidates/{id}/

`GET /candidates/{id}/`

Retrieve a candidate by id.

## Response `200`

- object
  - `id` integer
  - `external_id` string, nullable — Id of the candidate in the API consumer systems
  - `full_name` string, required — Full name of the candidate
  - `creator` integer — User who created the candidate
  - `owner` integer, nullable — ID of the owner of the candidate - default to creator if none is provided
  - `source_type` 'sourced' | 'applied' | 'referred' | 'agency' | 'other' — Origin of the candidate
  - `source_other` string, nullable — Field to add manual information to the source if the source_type is other
  - `source_details` object — The source details of the candidate
    - `type` string
    - `channel` string
    - `portal` object
      - `id` integer
      - `display_name` string
    - `referrer` object
      - `id` integer
      - `full_name` string
    - `agency` object
      - `id` integer
      - `given_name` string
    - `other_label` string
    - `reference` string
  - `candidate_tags` object[] — Tags assigned to the candidate
    - `id` integer — Candidate-tag assignment id
    - `tag_id` integer — Tag id in Manatal
    - `tag_name` string — Tag label
    - `tag_color` string — Tag color (hex)
  - `candidate_industries` object[] — Industries assigned to the candidate
    - `id` integer — Candidate-industry assignment id
    - `industry` integer — Industry id in Manatal
    - `industry_name` string — Industry display name
    - `candidate` integer — Candidate id
    - `creator_name` string — Display name of the user who created the assignment (`None` when missing)
  - `skills` object[] — Skills assigned to the candidate
    - `id` integer
    - `skill` integer, nullable — Skill id in Manatal
    - `skill_name` string — Skill display name
    - `score` integer
    - `source` 'form' | 'linkedin_extension' | 'resume_sovren' | 'resume_parsy' | 'resume_mcp' | 'file_import' | 'openapi', nullable
    - `created_at` string, date-time
    - `updated_at` string, date-time
  - `consent` boolean, nullable — Whether the candidate gave permission to use his data (GDPR,Brazil's LGPD, USA´s CCPA ...)
  - `consent_date` string, date-time — Date at which the candidate gave his consent
  - `picture` string, uri — Link to the candidate picture
  - `email` string, email, nullable — Candidate email
  - `resume` string — Link to the candidate resume
  - `phone_number` string, nullable — Candidate phone number
  - `gender` 'male' | 'female' | 'other' | 'unknown', nullable — Gender of the candidate
  - `birth_date` string, date, nullable — Candidate birth date
  - `address` string — Full address of the candidate
  - `zipcode` string — Code for the city of the address field
  - `latest_degree` string, nullable — Latest degree obtained by the candidate
  - `latest_university` string, nullable — Latest university the candidate graduated from
  - `current_company` string, nullable — Company where the candidate currently works
  - `current_department` string, nullable — Department where the candidate works
  - `current_position` string, nullable — Position of the candidate at his current job
  - `description` string — Description of the candidate - can only input text here.
  - `hash` string — Unique hash of the candidate
  - `custom_fields` object — Candidate values for custom fields defined in Manatal.
  - `created_at` string, date-time — Date at which the candidate was created
  - `updated_at` string, date-time

---

[API](https://skmtc.net/manatal/apis/manatal-career-page-api.md) · [All operations](https://skmtc.net/manatal/apis/manatal-career-page-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/manatal/manatal-career-page-api/versions/59053f2da83c/schema)