---
title: "/candidates"
method: GET
path: "/candidates"
---

# /candidates

`GET /candidates`

Returns a collection of the job's candidates. Required scope: `r_candidates`. Accessible with all token types.

## Query parameters

- `email` string
- `shortcode` string
- `stage` string
- `limit` integer
- `since_id` string
- `max_id` string
- `created_after` string, date-time
- `updated_after` string, date-time

## Response `200`

200

- object
  - `candidates` object[]
    - `id` string
    - `name` string
    - `firstname` string
    - `lastname` string
    - `headline` string
    - `account` object
      - `subdomain` string
      - `name` string
    - `job` object
      - `shortcode` string
      - `title` string
    - `stage` string
    - `disqualified` boolean
    - `disqualification_reason` unknown
    - `sourced` boolean
    - `profile_url` string
    - `email` string
    - `domain` string
    - `created_at` string
    - `updated_at` string
    - `resume_metadata` object
      - `filename` string
      - `filetype` string
      - `created_at` string, date-time
      - `updated_at` string, date-time
    - `name1` string
  - `paging` object
    - `next` string

## Other responses

- `401` — 401
- `404` — 404

---

[API](https://skmtc.net/workable/apis/account-root.md) · [All operations](https://skmtc.net/workable/apis/account-root/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/workable/account-root/versions/3ead9ec42165/schema)