> ## Documentation Index
> Fetch the complete documentation index at: https://docs.linkupapi.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Get Job Candidates
> Retrieve candidates who applied to a specific job posting.
## Overview
Returns the candidates who applied to a specific job posting. Pagination is **offset-based** — set `count` for the page size and `offset` to skip ahead.
This endpoint consumes **1 credit per 10 results** returned. The platform returns up to **50 candidates per internal request**, so larger `count` values trigger multiple upstream calls automatically. Ignore this if you're on per-seat pricing: usage is unlimited.
## Request
Your API key for authentication.
The unique identifier of the account to use.
Must be `"get_candidates"`.
The numeric job ID to retrieve candidates for.
Number of candidates to return. Defaults to `10`. **Capped at `1000`** per call.
Zero-indexed offset into the candidates list. Defaults to `0`. Use `pagination.next_offset` from a previous response to fetch the next page.
Ratings to include, comma-separated. Defaults to all ratings.
`RELEVANCE` or `APPLIED_DATE`.
`DESCENDING` or `ASCENDING`.
## Response
Indicates whether the request was successful.
List of candidates.
Unique application ID — use it with `get_cv`.
Recruiter rating: `"UNRATED"`, `"GOOD_FIT"`, `"MAYBE"`, `"NOT_A_FIT"`.
`true` when the candidate is in the Rejected stage. Keep `false` to get the candidates in review.
Rejection date (`YYYY-MM-DD HH:MM:SS`), `null` when not rejected.
`true` when the candidate marked the job as a top choice.
Optional message left by the candidate.
First name.
Last name.
Full name.
Headline.
Vanity slug.
Public profile URL.
Candidate location.
Work experience entries with `title`, `company`, `company_url`, `date_range` (e.g. `"2/2025 - 7/2025"`), `description`.
Number of candidates returned in this response.
Total number of candidates that applied to the job.
Offset of the first candidate in this response.
Number of candidates returned (mirrors `total_results`).
Offset to send as `offset` in the next request. `null` when exhausted.
`true` if more candidates are available.
Maximum batch size used per upstream request (50).
Number of internal upstream batches consumed.
The action that was performed (`"get_candidates"`).
The account ID used for the request.
Number of credits consumed (1 per 10 results).
ISO 8601 timestamp of the response.
```json 200 theme={null}
{
"success": true,
"data": {
"candidates": [
{
"application_id": "26905743894",
"rating": "UNRATED",
"is_rejected": false,
"rejected_at": null,
"is_top_choice": false,
"top_choice_message": "",
"first_name": "Jane",
"last_name": "Doe",
"full_name": "Jane Doe",
"headline": "Digital Marketing Strategist | SEO, SEM & Analytics",
"public_identifier": "jane-doe-42",
"profile_url": "https://www.linkedin.com/in/jane-doe-42",
"location": "Paris, France",
"experiences": [
{
"title": "Digital Marketing Intern",
"company": "Acme Corp",
"company_url": "https://www.linkedin.com/company/acme-corp/",
"date_range": "2/2025 - 7/2025",
"description": ""
}
]
}
],
"total_results": 1,
"total_available_results": 81,
"pagination": {
"offset": 0,
"count": 1,
"next_offset": 1,
"has_more": true,
"results_per_page": 50,
"pages_fetched": 1
}
},
"metadata": {
"action": "get_candidates",
"account_id": "your-account-id",
"credits_consumed": 1,
"timestamp": "2026-04-26T10:35:00Z"
}
}
```
```json 400 theme={null}
{
"success": false,
"error": {
"code": "INVALID_PARAMS",
"message": "job_id is required."
},
"metadata": {
"action": "get_candidates",
"account_id": "your-account-id",
"credits_consumed": 0,
"timestamp": "2026-04-26T10:35:00Z"
}
}
```