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

# GET /candidates/

`GET /candidates/`

Retrieve all candidates ordered alphabetically.

## Query parameters

- `id` integer
- `full_name` string
- `creator_id` integer
- `owner_id` integer
- `source_type` string
- `email` string
- `phone_number` string
- `gender` string
- `birth_date__gte` string
- `birth_date__lte` string
- `address` string
- `latest_degree` string
- `latest_university` string
- `current_company` string
- `current_position` string
- `description` string
- `external_id` string
- `candidate_tags` string
- `candidate_industries` string
- `candidate_location` string
- `created_at__gte` string
- `created_at__lte` string
- `updated_at__gte` string
- `updated_at__lte` string
- `page` integer
- `page_size` integer

## Response `200`

- object
  - `count` integer, required
  - `next` string, uri, nullable
  - `previous` string, uri, nullable
  - `results` object[], required
    - `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
    - `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
    - `candidate_location` string, nullable — Location of the candidate
    - `candidate_tags` object[] — List of tags associated with the candidate
      - `id` integer
      - `tag_id` integer
      - `tag_name` string
      - `tag_color` string
    - `candidate_industries` object[] — List of industries associated with the candidate
      - `id` integer
      - `industry` integer
      - `industry_name` string
      - `candidate` integer
      - `creator_name` string
    - `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)