---
title: "Changes to Get candidates"
method: GET
path: "/ats/candidates"
---

# Changes to Get candidates

`GET /ats/candidates`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 1 of 39 revisions.

- **2026-07-13** `d0e06abf1118`: 1 breaking, 36 info

## Changes

- **2026-07-13** `d0e06abf1118`: 1 breaking, 36 info
  - the `data/results/items/` response's property type changed from no type to `object` for status `200`
  - added the new optional `query` request parameter `email`
  - added the new optional `query` request parameter `first_name`
  - added the new optional `query` request parameter `ignore_unsupported_filters`
  - added the new optional `query` request parameter `job_ids`
  - added the new optional `query` request parameter `last_name`
  - removed the pattern `/^([\da-z]{24}(,[\da-z]{24})*)?$/i` from the `query` request parameter `ids`
  - removed the non-success response with the status `400`
  - removed the non-success response with the status `401`
  - removed the non-success response with the status `403`
  - removed the non-success response with the status `404`
  - removed the non-success response with the status `503`
  - added the optional property `data/results/items/email_addresses` to the response with the `200` status
  - added the optional property `data/results/items/location` to the response with the `200` status
  - added the optional property `data/results/items/phone_numbers` to the response with the `200` status
  - added the optional property `data/results/items/social_media` to the response with the `200` status
  - removed `subschema #1, subschema #2` from the `data/results/items/` response property `allOf` list for the response status `200`
  - the `status` response property const value `success` was added for the status `200`
  - removed the `success` enum value from the `status` response property for the response status `200`
  - added the required property `data/results/items/applications` to the response with the `200` status
  - added the required property `data/results/items/changed_at` to the response with the `200` status
  - added the required property `data/results/items/company` to the response with the `200` status
  - added the required property `data/results/items/confidential` to the response with the `200` status
  - added the required property `data/results/items/custom_fields` to the response with the `200` status
  - added the required property `data/results/items/first_name` to the response with the `200` status
  - added the required property `data/results/items/id` to the response with the `200` status
  - added the required property `data/results/items/integration_fields` to the response with the `200` status
  - added the required property `data/results/items/last_name` to the response with the `200` status
  - added the required property `data/results/items/remote_created_at` to the response with the `200` status
  - added the required property `data/results/items/remote_data` to the response with the `200` status
  - added the required property `data/results/items/remote_deleted_at` to the response with the `200` status
  - added the required property `data/results/items/remote_id` to the response with the `200` status
  - added the required property `data/results/items/remote_updated_at` to the response with the `200` status
  - added the required property `data/results/items/remote_url` to the response with the `200` status
  - added the required property `data/results/items/source` to the response with the `200` status
  - added the required property `data/results/items/tags` to the response with the `200` status
  - added the required property `data/results/items/title` to the response with the `200` status

---

[Operation](https://skmtc.dev/kombo/apis/kombo-api/docs/ats/candidates/get.md) - [API](https://skmtc.dev/kombo/apis/kombo-api.md) - [Page](https://skmtc.dev/kombo/apis/kombo-api/changes/ats/candidates/get)