# Candidate (/ats/reference/objects/candidate)

A person a workspace knows as a possible hire. They are in the workspace's records whether or not they are on a job: see `jobs` for the jobs they are on.

```graphql
type Candidate {
  bannerUrl: String
  createdAt: DateTime!
  currentCompany: String
  currentTitle: String
  cvUrl: String
  email: String
  favouritedAt: DateTime
  id: ID!
  isArchived: Boolean!
  isEmailVerified: Boolean!
  jobs(
    after: String
    before: String
    first: Int
    last: Int
  ): JobCandidateConnection!
  lastActivityAt: DateTime
  lastActivityKind: CandidateActivityKind
  lastCallAt: DateTime
  lastCallTitle: String
  lastNoteAt: DateTime
  linkedinUrl: String
  location: String
  locationCity: String
  locationCountryCode: String
  locationRegion: String
  name: String!
  notes: String
  phone: String
  photoUrl: String
  salary: String
  source: String
  tags: [String!]!
  updatedAt: DateTime!
  yearsExperience: Int
}
```

### Fields [#fields]

#### [`Candidate.bannerUrl`](#banner-url) · [`String`](/ats/reference/scalars/string) `scalar` [#banner-url]
The banner image from their profile.

#### [`Candidate.createdAt`](#created-at) · [`DateTime!`](/ats/reference/scalars/date-time) `non-null` `scalar` [#created-at]
When they were added to the workspace.

#### [`Candidate.currentCompany`](#current-company) · [`String`](/ats/reference/scalars/string) `scalar` [#current-company]
The name of the company they work at today.

#### [`Candidate.currentTitle`](#current-title) · [`String`](/ats/reference/scalars/string) `scalar` [#current-title]
Their job title today.

#### [`Candidate.cvUrl`](#cv-url) · [`String`](/ats/reference/scalars/string) `scalar` [#cv-url]
A link to their CV.

#### [`Candidate.email`](#email) · [`String`](/ats/reference/scalars/string) `scalar` [#email]
Their email address.

#### [`Candidate.favouritedAt`](#favourited-at) · [`DateTime`](/ats/reference/scalars/date-time) `scalar` [#favourited-at]
When the workspace marked them as exceptional. Null when it has not.

#### [`Candidate.id`](#id) · [`ID!`](/ats/reference/scalars/id) `non-null` `scalar` [#id]
The candidate's id, as in their URL in the app.

#### [`Candidate.isArchived`](#is-archived) · [`Boolean!`](/ats/reference/scalars/boolean) `non-null` `scalar` [#is-archived]
True when they have been put away and are left out of everyday lists.

#### [`Candidate.isEmailVerified`](#is-email-verified) · [`Boolean!`](/ats/reference/scalars/boolean) `non-null` `scalar` [#is-email-verified]
True when an enrichment provider confirmed the email address reaches them.

#### [`Candidate.jobs`](#jobs) · [`JobCandidateConnection!`](/ats/reference/objects/job-candidate-connection) `non-null` `object` [#jobs]
The jobs they are on, each with their stage, grade and decision there, in the order they were added.
##### [`Candidate.jobs.after`](#candidate-jobs-after) · [`String`](/ats/reference/scalars/string) `scalar` [#candidate-jobs-after]
Return the rows that follow this cursor.

##### [`Candidate.jobs.before`](#candidate-jobs-before) · [`String`](/ats/reference/scalars/string) `scalar` [#candidate-jobs-before]
Return the rows that come before this cursor.

##### [`Candidate.jobs.first`](#candidate-jobs-first) · [`Int`](/ats/reference/scalars/int) `scalar` [#candidate-jobs-first]
How many rows to return, from the start or from `after`. 50 when left out, 200 at most.

##### [`Candidate.jobs.last`](#candidate-jobs-last) · [`Int`](/ats/reference/scalars/int) `scalar` [#candidate-jobs-last]
How many rows to return, counting back from the end or from `before`. 200 at most.

#### [`Candidate.lastActivityAt`](#last-activity-at) · [`DateTime`](/ats/reference/scalars/date-time) `scalar` [#last-activity-at]
When anything last happened with them: a note, a call, a stage move or a decision.

#### [`Candidate.lastActivityKind`](#last-activity-kind) · [`CandidateActivityKind`](/ats/reference/enums/candidate-activity-kind) `enum` [#last-activity-kind]
What that latest thing was.

#### [`Candidate.lastCallAt`](#last-call-at) · [`DateTime`](/ats/reference/scalars/date-time) `scalar` [#last-call-at]
When the latest recorded call with them took place.

#### [`Candidate.lastCallTitle`](#last-call-title) · [`String`](/ats/reference/scalars/string) `scalar` [#last-call-title]
The title of that latest call.

#### [`Candidate.lastNoteAt`](#last-note-at) · [`DateTime`](/ats/reference/scalars/date-time) `scalar` [#last-note-at]
When someone last left a note about them.

#### [`Candidate.linkedinUrl`](#linkedin-url) · [`String`](/ats/reference/scalars/string) `scalar` [#linkedin-url]
Their LinkedIn profile.

#### [`Candidate.location`](#location) · [`String`](/ats/reference/scalars/string) `scalar` [#location]
Where they are based, as written on their profile.

#### [`Candidate.locationCity`](#location-city) · [`String`](/ats/reference/scalars/string) `scalar` [#location-city]
The city from `location`, when it could be worked out.

#### [`Candidate.locationCountryCode`](#location-country-code) · [`String`](/ats/reference/scalars/string) `scalar` [#location-country-code]
The country from `location`, as a two-letter ISO 3166 code such as `GB`.

#### [`Candidate.locationRegion`](#location-region) · [`String`](/ats/reference/scalars/string) `scalar` [#location-region]
The state, county or region from `location`, when it could be worked out.

#### [`Candidate.name`](#name) · [`String!`](/ats/reference/scalars/string) `non-null` `scalar` [#name]
Their full name.

#### [`Candidate.notes`](#notes) · [`String`](/ats/reference/scalars/string) `scalar` [#notes]
General notes about them, apart from any job.

#### [`Candidate.phone`](#phone) · [`String`](/ats/reference/scalars/string) `scalar` [#phone]
Their phone number, as it was entered.

#### [`Candidate.photoUrl`](#photo-url) · [`String`](/ats/reference/scalars/string) `scalar` [#photo-url]
A photo of them.

#### [`Candidate.salary`](#salary) · [`String`](/ats/reference/scalars/string) `scalar` [#salary]
What they earn or expect, as it was written down.

#### [`Candidate.source`](#source) · [`String`](/ats/reference/scalars/string) `scalar` [#source]
How they came to be in the workspace, such as an import or the browser extension.

#### [`Candidate.tags`](#tags) · [`[String!]!`](/ats/reference/scalars/string) `non-null` `scalar` [#tags]
The workspace's own labels for them.

#### [`Candidate.updatedAt`](#updated-at) · [`DateTime!`](/ats/reference/scalars/date-time) `non-null` `scalar` [#updated-at]
When their record last changed.

#### [`Candidate.yearsExperience`](#years-experience) · [`Int`](/ats/reference/scalars/int) `scalar` [#years-experience]
How many years they have worked.

### Returned By [#returned-by]

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

### Member Of [#member-of]

[`CandidateEdge`](/ats/reference/objects/candidate-edge)  `object` · [`JobCandidate`](/ats/reference/objects/job-candidate)  `object`