# JobCandidateFilter (/api/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!]
  isUnassigned: Boolean
  jobIds: [ID!]
  knownByUserId: ID
  ownerIds: [ID!]
  stages: [JobCandidateStage!]
}
```

### Fields [#fields]

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

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

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

#### [`JobCandidateFilter.isUnassigned`](#is-unassigned) · [`Boolean`](/api/reference/scalars/boolean) `scalar` [#is-unassigned]
True for places with no owner, false for those with one. True cannot be combined with `ownerIds`.

#### [`JobCandidateFilter.jobIds`](#job-ids) · [`[ID!]`](/api/reference/scalars/id) `list` `scalar` [#job-ids]
Only places on these jobs. 200 at most. For the workspace-wide list; on a job's own list it adds nothing.

#### [`JobCandidateFilter.knownByUserId`](#known-by-user-id) · [`ID`](/api/reference/scalars/id) `scalar` [#known-by-user-id]
Only places of candidates this teammate knows personally.

#### [`JobCandidateFilter.ownerIds`](#owner-ids) · [`[ID!]`](/api/reference/scalars/id) `list` `scalar` [#owner-ids]
Only places whose owner is one of these teammates. 200 at most.

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

### Member Of [#member-of]

[`jobCandidates`](/api/reference/queries/job-candidates)  `query`