# jobCandidates (/api/reference/queries/job-candidates)

Candidates' places on jobs across the workspace, oldest first. For one job's list, read `Job.candidates`.

```graphql
jobCandidates(
  after: String
  before: String
  filter: JobCandidateFilter
  first: Int
  last: Int
): JobCandidateConnection!
```

### Arguments [#arguments]

#### [`jobCandidates.after`](#after) · [`String`](/api/reference/scalars/string) `scalar` [#after]
Return the rows that follow this cursor.

#### [`jobCandidates.before`](#before) · [`String`](/api/reference/scalars/string) `scalar` [#before]
Return the rows that come before this cursor.

#### [`jobCandidates.filter`](#filter) · [`JobCandidateFilter`](/api/reference/inputs/job-candidate-filter) `input` [#filter]
Narrow the list. Left out, every place on every job is returned.

#### [`jobCandidates.first`](#first) · [`Int`](/api/reference/scalars/int) `scalar` [#first]
How many rows to return, from the start or from `after`. 50 when left out, 200 at most.

#### [`jobCandidates.last`](#last) · [`Int`](/api/reference/scalars/int) `scalar` [#last]
How many rows to return, counting back from the end or from `before`. 200 at most.

### Type [#type]

#### [`JobCandidateConnection`](/api/reference/objects/job-candidate-connection) `object` [#jobcandidateconnection-object]
A page of candidates' places on jobs.

## Shown in the UI [#shown-in-the-ui]

These components show the `JobCandidate` it gives back:

- [Review card](/ui/candidate-review-card): One person against a role, with your actions.
- [Pipeline list](/ui/candidate-pipeline-list): The roles a person is in the pipeline for.
- [Assessment](/ui/candidate-assessment): A grade with its evidence and caveats.
- [Grade badge](/ui/candidate-grade): A grade letter with your own label and tone.
- [Shortlist](/ui/candidate-shortlist): People, a note from you, and a client decision.
- [Pipeline card](/ui/candidate-pipeline-card): A dense card for a board column.
- [Pipeline board](/ui/candidate-pipeline-board): A job's pipeline as a board, a column per stage.