# JobCandidateFilter (/ats/reference/inputs/job-candidate-filter)

Which candidates on a job to list. Every condition given must hold.

```graphql
input JobCandidateFilter {
  candidateIds: [ID!]
  decisions: [JobCandidateDecision!]
  grades: [JobCandidateGrade!]
  stages: [JobCandidateStage!]
}
```

### Fields [#fields]

#### [`JobCandidateFilter.candidateIds`](#candidate-ids) · [`[ID!]`](/ats/reference/scalars/id) `list` `scalar` [#candidate-ids]
Only these candidates, by their ids. 200 at most.

#### [`JobCandidateFilter.decisions`](#decisions) · [`[JobCandidateDecision!]`](/ats/reference/enums/job-candidate-decision) `list` `enum` [#decisions]
Only candidates with one of these decisions.

#### [`JobCandidateFilter.grades`](#grades) · [`[JobCandidateGrade!]`](/ats/reference/enums/job-candidate-grade) `list` `enum` [#grades]
Only candidates with one of these grades.

#### [`JobCandidateFilter.stages`](#stages) · [`[JobCandidateStage!]`](/ats/reference/enums/job-candidate-stage) `list` `enum` [#stages]
Only candidates at one of these stages.