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

# Changes to Get Candidates

`GET /api/ats/v1/candidates`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 4 of 23 revisions.

- **2026-10-06** `1f9bc0ad4bfb`: 11 info
- **2026-09-27** `cf8209fb1cd7`: 1 warning, 1 info
- **2026-08-24** `a606b0cf18c9`: 16 info
- **2026-08-01** `eb3486b88e55`: 3 info

## Changes

- **2026-10-06** `1f9bc0ad4bfb`: 11 info
  - the endpoint scheme security `HTTPBearer AND ConnectorToken` was added to the API
  - the endpoint scheme security `ConnectorToken` was removed from the API
  - the endpoint scheme security `HTTPBearer` was removed from the API
  - removed the `-` enum value from the `items/items/urls/anyOf[subschema #1]/items/url_type` response property for the response status `200`
  - removed the `BLOG` enum value from the `items/items/urls/anyOf[subschema #1]/items/url_type` response property for the response status `200`
  - removed the `COMPANY` enum value from the `items/items/urls/anyOf[subschema #1]/items/url_type` response property for the response status `200`
  - removed the `JOB_POSTING` enum value from the `items/items/urls/anyOf[subschema #1]/items/url_type` response property for the response status `200`
  - removed the `OTHER` enum value from the `items/items/urls/anyOf[subschema #1]/items/url_type` response property for the response status `200`
  - removed the `PERSONAL` enum value from the `items/items/urls/anyOf[subschema #1]/items/url_type` response property for the response status `200`
  - removed the `PORTFOLIO` enum value from the `items/items/urls/anyOf[subschema #1]/items/url_type` response property for the response status `200`
  - removed the `SOCIAL_MEDIA` enum value from the `items/items/urls/anyOf[subschema #1]/items/url_type` response property for the response status `200`
- **2026-09-27** `cf8209fb1cd7`: 1 warning, 1 info
  - deleted the `header` request parameter `x-connector-token`
  - the endpoint scheme security `ConnectorToken` was added to the API
- **2026-08-24** `a606b0cf18c9`: 16 info
  - `query` request parameter `cursor` list-of-types was widened by adding types `null`
  - `query` request parameter `email_addresses` list-of-types was widened by adding types `null`
  - `query` request parameter `expand` list-of-types was widened by adding types `null`
  - `query` request parameter `first_name` list-of-types was widened by adding types `null`
  - `query` request parameter `last_name` list-of-types was widened by adding types `null`
  - `query` request parameter `modified_after` list-of-types was widened by adding types `null`
  - `query` request parameter `remote_id` list-of-types was widened by adding types `null`
  - `query` request parameter `tag` list-of-types was widened by adding types `null`
  - for the `query` request parameter `cursor`, the type was generalized from `string` to no type
  - for the `query` request parameter `email_addresses`, the type was generalized from `array` to no type
  - for the `query` request parameter `expand`, the type was generalized from `string` to no type
  - for the `query` request parameter `first_name`, the type was generalized from `string` to no type
  - for the `query` request parameter `last_name`, the type was generalized from `string` to no type
  - for the `query` request parameter `modified_after`, the type was generalized from `string` to no type
  - for the `query` request parameter `remote_id`, the type was generalized from `string` to no type
  - for the `query` request parameter `tag`, the type was generalized from `string` to no type
- **2026-08-01** `eb3486b88e55`: 3 info
  - added the non-success response with the status `401`
  - added the non-success response with the status `403`
  - added the non-success response with the status `429`

---

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