# candidateEmployments (/api/reference/queries/candidate-employments)

Roles held by the workspace's candidates, oldest record first. For one candidate's own history, read `Candidate.employments`.

```graphql
candidateEmployments(
  after: String
  before: String
  filter: CandidateEmploymentFilter
  first: Int
  last: Int
): CandidateEmploymentConnection!
```

### Arguments [#arguments]

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

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

#### [`candidateEmployments.filter`](#filter) · [`CandidateEmploymentFilter`](/api/reference/inputs/candidate-employment-filter) `input` [#filter]
Narrow the list. Left out, every role of every candidate is returned.

#### [`candidateEmployments.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.

#### [`candidateEmployments.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]

#### [`CandidateEmploymentConnection`](/api/reference/objects/candidate-employment-connection) `object` [#candidateemploymentconnection-object]
A page of roles candidates have held.