# candidates (/api/reference/queries/candidates)

The workspace's candidates, oldest first. Candidates still in Kith ATS's own sourcing review are not included.

```graphql
candidates(
  after: String
  before: String
  filter: CandidateFilter
  first: Int
  last: Int
): CandidateConnection!
```

### Arguments [#arguments]

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

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

#### [`candidates.filter`](#filter) · [`CandidateFilter`](/api/reference/inputs/candidate-filter) `input` [#filter]
Narrow the list. Left out, every candidate is returned, archived ones included.

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

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

#### [`CandidateConnection`](/api/reference/objects/candidate-connection) `object` [#candidateconnection-object]
A page of candidates.

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

These components show the `Candidate` it gives back:

- [Review card](/ui/candidate-review-card): One person against a role, with your actions.
- [Inline card](/ui/candidate-inline-card): A compact candidate row for lists and messages.
- [Profile](/ui/candidate-profile): Identity, career history and contact channels.
- [Profile dialog](/ui/candidate-profile-dialog): A profile in a dialog, or a drawer on a phone.
- [Cover header](/ui/candidate-cover-header): A cover and an identity, as cards and profiles share them.