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

Which candidates to list. Every condition given must hold.

```graphql
input CandidateFilter {
  currentCompany: String
  emails: [String!]
  hasCall: Boolean
  hasEmail: Boolean
  hasLinkedin: Boolean
  hasNote: Boolean
  ids: [ID!]
  isArchived: Boolean
  isEmailVerified: Boolean
  isFavourite: Boolean
  isUnassigned: Boolean
  knownByUserId: ID
  linkedinUrls: [String!]
  location: CandidateLocationFilter
  names: [String!]
  ownerIds: [ID!]
  search: String
  titleContains: String
}
```

### Fields [#fields]

#### [`CandidateFilter.currentCompany`](#current-company) · [`String`](/api/reference/scalars/string) `scalar` [#current-company]
Only candidates whose current company is exactly this.

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

#### [`CandidateFilter.hasCall`](#has-call) · [`Boolean`](/api/reference/scalars/boolean) `scalar` [#has-call]
True for candidates with a linked call, false for those without.

#### [`CandidateFilter.hasEmail`](#has-email) · [`Boolean`](/api/reference/scalars/boolean) `scalar` [#has-email]
True for candidates with an email address, false for those without.

#### [`CandidateFilter.hasLinkedin`](#has-linkedin) · [`Boolean`](/api/reference/scalars/boolean) `scalar` [#has-linkedin]
True for candidates with a LinkedIn profile, false for those without.

#### [`CandidateFilter.hasNote`](#has-note) · [`Boolean`](/api/reference/scalars/boolean) `scalar` [#has-note]
True for candidates with a note a person left, false for those without. An entry with no words, and call transcripts, do not count as notes.

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

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

#### [`CandidateFilter.isEmailVerified`](#is-email-verified) · [`Boolean`](/api/reference/scalars/boolean) `scalar` [#is-email-verified]
True for candidates whose email address has been confirmed, false for the rest.

#### [`CandidateFilter.isFavourite`](#is-favourite) · [`Boolean`](/api/reference/scalars/boolean) `scalar` [#is-favourite]
True for candidates the workspace marked as exceptional, false for the rest.

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

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

#### [`CandidateFilter.linkedinUrls`](#linkedin-urls) · [`[String!]`](/api/reference/scalars/string) `list` `scalar` [#linkedin-urls]
Only candidates with one of these LinkedIn profiles, however the address is written: the scheme, `www.`, a trailing slash, a query and a fragment are ignored, and so is case. 200 at most.

#### [`CandidateFilter.location`](#location) · [`CandidateLocationFilter`](/api/reference/inputs/candidate-location-filter) `input` [#location]
Only candidates based here.

#### [`CandidateFilter.names`](#names) · [`[String!]`](/api/reference/scalars/string) `list` `scalar` [#names]
Only candidates with one of these names, matched exactly. 200 at most.

#### [`CandidateFilter.ownerIds`](#owner-ids) · [`[ID!]`](/api/reference/scalars/id) `list` `scalar` [#owner-ids]
Only candidates owned by one of these teammates. 200 at most.

#### [`CandidateFilter.search`](#search) · [`String`](/api/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.

#### [`CandidateFilter.titleContains`](#title-contains) · [`String`](/api/reference/scalars/string) `scalar` [#title-contains]
Only candidates whose current title contains this text, in any case. 200 characters at most.

### Member Of [#member-of]

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