# CandidateFilter (/ats/reference/inputs/candidate-filter)

Which candidates to list. Every condition given must hold.

```graphql
input CandidateFilter {
  emails: [String!]
  ids: [ID!]
  isArchived: Boolean
  linkedinUrls: [String!]
  search: String
}
```

### Fields [#fields]

#### [`CandidateFilter.emails`](#emails) · [`[String!]`](/ats/reference/scalars/string) `list` `scalar` [#emails]
Only candidates with one of these email addresses. 200 at most.

#### [`CandidateFilter.ids`](#ids) · [`[ID!]`](/ats/reference/scalars/id) `list` `scalar` [#ids]
Only these candidates. 200 at most.

#### [`CandidateFilter.isArchived`](#is-archived) · [`Boolean`](/ats/reference/scalars/boolean) `scalar` [#is-archived]
True for archived candidates only, false for the rest. Left out, both are returned.

#### [`CandidateFilter.linkedinUrls`](#linkedin-urls) · [`[String!]`](/ats/reference/scalars/string) `list` `scalar` [#linkedin-urls]
Only candidates with one of these LinkedIn profile URLs, matched exactly as stored. 200 at most.

#### [`CandidateFilter.search`](#search) · [`String`](/ats/reference/scalars/string) `scalar` [#search]
Only candidates whose name, current title or current company contains this text, exactly as written but in any case. 200 characters at most.

### Member Of [#member-of]

[`candidates`](/ats/reference/queries/candidates)  `query`