/company/{id}/position/{id}/candidates

get

https://api.breezy.hr/v3/company/{companyId}/position/{positionId}/candidates

Returns the candidates on a given position within a company, as an array of candidate summaries (id, name, contact info, stage, source, score, resume link, etc.). Pass stage_id to restrict the result to one pipeline stage.

By default all candidates on the position are returned in a single unpaged response. Supplying page_size switches to paged mode: page_size is capped at 50 regardless of the value requested, page is 1-based (page=1 is the first page; page=0 also returns the first page), and sort defaults to updated.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Path Params

companyId

string

required

positionId

string

required

Query Params

page_size

integer

≤ 50

Number of candidates per page, capped at 50. Omit page_size to receive the full unpaged list.

page

integer

Defaults to 1

Page number, only used when page_size is set. Paging is effectively 1-based - page=1 returns the first page and page=2 the second. page=0 (and an omitted page) also returns the first page, so a client that counts from 0 receives the first page twice. This offset is long-standing behavior and is preserved for backward compatibility.

sort

string

stage_id

string

length ≤ 64

^[A-Za-z0-9_-]{1,64}$

Optional. Only return candidates currently in this pipeline stage. Use the stage id values from GET /company/{companyId}/pipeline/{pipelineId} - built-in stages are strings such as applied, custom stages are numeric ids. Works with and without page_size. An unknown stage id returns an empty list; a value that is not a plain token of letters, digits, _ or - returns 400.

Response

200List of candidates