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

# GET /candidates/{id}/

`GET /candidates/{id}/`

## Request

- Base URL: `https://api.manatal.com/open/v3`
- URL: `https://api.manatal.com/open/v3/candidates/{id}/`
- Auth: API key in header `Authorization`

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.dev/manatal/apis/manatal-open-api.md) - [All operations](https://skmtc.dev/manatal/apis/manatal-open-api/llms.txt) - [OpenAPI document](https://skmtc.dev/manatal/apis/manatal-open-api/revisions/564633b3d03b?raw)