Candidates

List candidates

Returns a paginated candidate list for one company or all companies accessible by the API key. Use filters for deduplication, exports, and incremental synchronization jobs.

get/candidates

Request

  • Base URL: https://api.100hires.com/v2
  • URL: https://api.100hires.com/v2/candidates
  • Auth: HTTP bearer

Query parameters

company_idinteger

Optional target company ID. Since each API key is already bound to one company, this is only needed when the key owner has access to multiple companies.

job_idinteger

Filter candidates by job ID.

stage_idinteger

Filter candidates by pipeline stage ID. Best used together with job_id.

emailstring

Exact candidate email filter.

qstring

Plain-text candidate search by name or email. Supports partial matches. If combined with other filters, all filters must match.

full_namestring

Candidate full-name filter. If combined with email or q, all supplied filters must match.

linkedinstring

Search by LinkedIn profile URL or alias. Accepts full URL (https://linkedin.com/in/johndoe) or just the alias (johndoe). Server normalizes before matching.

integer
OR
string

Return only candidates created at or after this time. Accepts a Unix timestamp in seconds (not milliseconds) or an ISO-8601 string with timezone offset (e.g. 2026-05-11T00:00:00Z, 2026-05-11T00:00:00.123+03:00). Fractional seconds are accepted but truncated to whole seconds.

integer
OR
string

Return only candidates updated at or after this time. Accepts a Unix timestamp in seconds (not milliseconds) or an ISO-8601 string with timezone offset (e.g. 2026-05-11T00:00:00Z, 2026-05-11T00:00:00.123+03:00). Fractional seconds are accepted but truncated to whole seconds. Use for incremental sync.

include'applications'

Include related application summaries in the candidate response.

pageinteger

Page number (1-based). Defaults to 1.

sizeinteger

Number of items per page (1–100). Defaults to 20.

view'full' | 'summary'

Response shape selector for list endpoints. full (default) returns every field — backward-compatible with pre-existing clients. summary returns a thinned payload designed for agent-friendly list browsing: heavy fields (description HTML, embedded profile answers, full message bodies, embedded relations, etc.) are omitted or replaced with *_preview truncations. Use summary when paging through large result sets and fetch a single record with the corresponding GET /{resource}/{id} endpoint when full data is needed.

Response

Candidate list

Example response

{
  "candidates": [
    {
      "alias": "dtGeby2",
      "url_backoffice": "https://app.100hires.com/candidate/dtGeby2"
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.