Skip to main content
POST
Bulk fetch job candidates

Authorizations

Authorization
string
header
required

Company-scoped API key. Production keys are prefixed sk_live_, sandbox keys sk_test_, each followed by 22 base62 characters (pattern ^sk_(live|test)_[0-9A-Za-z]{22}$). Generate keys in the TapTalent dashboard under Account Settings → Developers → API Key Management; a key is shown once at generation and old keys are invalidated immediately on regeneration.

Body

application/json

Request body for bulk-fetching job candidates by ID.

jobCandidateIds
(integer | string)[]
required

Array of job candidate IDs to fetch. Maximum 100 IDs per request; must be provided and cannot be empty.

Required array length: 1 - 100 elements

A job candidate ID. Each ID must be a valid non-empty string or number.

Response

Job candidates fetched successfully.

Success envelope for the bulk-fetch job candidates endpoint.

status
enum<string>
required

Response status ("success").

Available options:
success
data
object[]
required

Array of job candidate objects.