# Candidate (/api/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
  callLinks(
    after: String
    before: String
    first: Int
    last: Int
  ): CallLinkConnection!
  createdAt: DateTime!
  currentCompany: String
  currentEmployer: Company
  currentTitle: String
  cvUrl: String
  documents(
    after: String
    before: String
    first: Int
    last: Int
  ): CandidateDocumentConnection!
  email: String
  emailVerifiedAt: DateTime
  emailVerifiedBy: EmailVerifier
  employments(
    after: String
    before: String
    filter: CandidateOwnEmploymentFilter
    first: Int
    last: Int
  ): CandidateEmploymentConnection!
  facts(
    after: String
    before: String
    filter: CandidateOwnFactFilter
    first: Int
    last: Int
  ): CandidateFactConnection!
  favouritedAt: DateTime
  id: ID!
  isArchived: Boolean!
  isEmailVerified: Boolean!
  jobs(
    after: String
    before: String
    first: Int
    last: Int
  ): JobCandidateConnection!
  knownBy(
    after: String
    before: String
    first: Int
    last: Int
  ): CandidateRelationshipConnection!
  lastActivityAt: DateTime
  lastActivityBy: User
  lastActivityKind: CandidateActivityKind
  lastCallAt: DateTime
  lastCallTitle: String
  lastNoteAt: DateTime
  latestCall: Call
  linkedinUrl: String
  location: String
  locationCity: String
  locationCountryCode: String
  locationRegion: String
  name: String!
  notes: String
  owner: User
  person: Person
  phone: String
  photoUrl: String
  presentations(
    after: String
    before: String
    first: Int
    last: Int
  ): PresentationConnection!
  relationshipSignals(
    after: String
    before: String
    filter: CandidateRelationshipSignalFilter
    first: Int
    last: Int
  ): RelationshipSignalConnection!
  roleRecommendations: [RoleRecommendation!]!
  salary: String
  source: String
  tags: [String!]!
  timelineNotes(
    after: String
    before: String
    first: Int
    last: Int
  ): CandidateNoteConnection!
  touches(
    after: String
    before: String
    first: Int
    last: Int
  ): TouchConnection!
  updatedAt: DateTime!
  yearsExperience: Int
}
```

### Fields [#fields]

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

#### [`Candidate.callLinks`](#call-links) · [`CallLinkConnection!`](/api/reference/objects/call-link-connection) `non-null` `object` [#call-links]
The calls they were on, most recently linked first. A link that has been removed is not listed.
##### [`Candidate.callLinks.after`](#candidate-call-links-after) · [`String`](/api/reference/scalars/string) `scalar` [#candidate-call-links-after]
Return the rows that follow this cursor.

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

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

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

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

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

#### [`Candidate.currentEmployer`](#current-employer) · [`Company`](/api/reference/objects/company) `object` [#current-employer]
The company record their current employer has been matched to. Null until `currentCompany` has been matched to one.

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

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

#### [`Candidate.documents`](#documents) · [`CandidateDocumentConnection!`](/api/reference/objects/candidate-document-connection) `non-null` `object` [#documents]
Their uploaded documents, newest first.
##### [`Candidate.documents.after`](#candidate-documents-after) · [`String`](/api/reference/scalars/string) `scalar` [#candidate-documents-after]
Return the rows that follow this cursor.

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

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

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

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

#### [`Candidate.emailVerifiedAt`](#email-verified-at) · [`DateTime`](/api/reference/scalars/date-time) `scalar` [#email-verified-at]
When the email address was confirmed to reach them. Null when `isEmailVerified` is false.

#### [`Candidate.emailVerifiedBy`](#email-verified-by) · [`EmailVerifier`](/api/reference/enums/email-verifier) `enum` [#email-verified-by]
How the email address was confirmed. Null when it has not been.

#### [`Candidate.employments`](#employments) · [`CandidateEmploymentConnection!`](/api/reference/objects/candidate-employment-connection) `non-null` `object` [#employments]
The roles they have held: current ones first, then the most recently started.
##### [`Candidate.employments.after`](#candidate-employments-after) · [`String`](/api/reference/scalars/string) `scalar` [#candidate-employments-after]
Return the rows that follow this cursor.

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

##### [`Candidate.employments.filter`](#candidate-employments-filter) · [`CandidateOwnEmploymentFilter`](/api/reference/inputs/candidate-own-employment-filter) `input` [#candidate-employments-filter]
Narrow the list. Left out, current and past roles are returned.

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

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

#### [`Candidate.facts`](#facts) · [`CandidateFactConnection!`](/api/reference/objects/candidate-fact-connection) `non-null` `object` [#facts]
Facts recorded about them, such as deal sizes or languages, in order of `kind`.
##### [`Candidate.facts.after`](#candidate-facts-after) · [`String`](/api/reference/scalars/string) `scalar` [#candidate-facts-after]
Return the rows that follow this cursor.

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

##### [`Candidate.facts.filter`](#candidate-facts-filter) · [`CandidateOwnFactFilter`](/api/reference/inputs/candidate-own-fact-filter) `input` [#candidate-facts-filter]
Narrow the list. Left out, every fact is returned.

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

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

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

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

#### [`Candidate.isArchived`](#is-archived) · [`Boolean!`](/api/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!`](/api/reference/scalars/boolean) `non-null` `scalar` [#is-email-verified]
True when an enrichment provider confirmed the email address reaches them.

#### [`Candidate.jobs`](#jobs) · [`JobCandidateConnection!`](/api/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`](/api/reference/scalars/string) `scalar` [#candidate-jobs-after]
Return the rows that follow this cursor.

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

##### [`Candidate.jobs.first`](#candidate-jobs-first) · [`Int`](/api/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`](/api/reference/scalars/int) `scalar` [#candidate-jobs-last]
How many rows to return, counting back from the end or from `before`. 200 at most.

#### [`Candidate.knownBy`](#known-by) · [`CandidateRelationshipConnection!`](/api/reference/objects/candidate-relationship-connection) `non-null` `object` [#known-by]
The teammates who know them personally, in the order they were recorded.
##### [`Candidate.knownBy.after`](#candidate-known-by-after) · [`String`](/api/reference/scalars/string) `scalar` [#candidate-known-by-after]
Return the rows that follow this cursor.

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

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

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

#### [`Candidate.lastActivityAt`](#last-activity-at) · [`DateTime`](/api/reference/scalars/date-time) `scalar` [#last-activity-at]
When anything last happened with them: a note, a call, a stage move or a decision. Worked out from what the workspace may read: a note or stage move on a job they are not yet released on does not count.

#### [`Candidate.lastActivityBy`](#last-activity-by) · [`User`](/api/reference/objects/user) `object` [#last-activity-by]
The teammate who did the latest thing counted in `lastActivityAt`, when a person did it and it is known who. Null for a teammate who has left the workspace.

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

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

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

#### [`Candidate.lastNoteAt`](#last-note-at) · [`DateTime`](/api/reference/scalars/date-time) `scalar` [#last-note-at]
When someone last left a note about them. A note about a job they are not yet released on does not count.

#### [`Candidate.latestCall`](#latest-call) · [`Call`](/api/reference/objects/call) `object` [#latest-call]
The latest call they were on, by when it was held. Null when no call is linked to them.

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

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

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

#### [`Candidate.locationCountryCode`](#location-country-code) · [`String`](/api/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`](/api/reference/scalars/string) `scalar` [#location-region]
The state, county or region from `location`, when it could be worked out.

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

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

#### [`Candidate.owner`](#owner) · [`User`](/api/reference/objects/user) `object` [#owner]
The teammate responsible for them. Null when nobody is assigned, and for a teammate who has left the workspace.

#### [`Candidate.person`](#person) · [`Person`](/api/reference/objects/person) `object` [#person]
The person this candidate is. Shared with a client contact when the same human is both.

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

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

#### [`Candidate.presentations`](#presentations) · [`PresentationConnection!`](/api/reference/objects/presentation-connection) `non-null` `object` [#presentations]
The times they were shown to a buyer, newest recorded first.
##### [`Candidate.presentations.after`](#candidate-presentations-after) · [`String`](/api/reference/scalars/string) `scalar` [#candidate-presentations-after]
Return the rows that follow this cursor.

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

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

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

#### [`Candidate.relationshipSignals`](#relationship-signals) · [`RelationshipSignalConnection!`](/api/reference/objects/relationship-signal-connection) `non-null` `object` [#relationship-signals]
The relationship signals about them that need attention now: open ones, and snoozed ones whose snooze has passed. Signals about the company they work at today are included. Most urgent first, then newest. Reading this records that the signals were shown to the reader, once for each signal.
##### [`Candidate.relationshipSignals.after`](#candidate-relationship-signals-after) · [`String`](/api/reference/scalars/string) `scalar` [#candidate-relationship-signals-after]
Return the rows that follow this cursor.

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

##### [`Candidate.relationshipSignals.filter`](#candidate-relationship-signals-filter) · [`CandidateRelationshipSignalFilter`](/api/reference/inputs/candidate-relationship-signal-filter) `input` [#candidate-relationship-signals-filter]
Narrow the list. Left out, every kind is returned.

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

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

#### [`Candidate.roleRecommendations`](#role-recommendations) · [`[RoleRecommendation!]!`](/api/reference/objects/role-recommendation) `non-null` `object` [#role-recommendations]
The roles their calls point to: open recommendations, and ones already acted on by adding them to the job. One for each job, newest first. Empty when their calls named none, and for calls the reader may not see: the reader's own, or every call of the workspace when it shares them.

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

#### [`Candidate.source`](#source) · [`String`](/api/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!]!`](/api/reference/scalars/string) `non-null` `scalar` [#tags]
The workspace's own labels for them.

#### [`Candidate.timelineNotes`](#timeline-notes) · [`CandidateNoteConnection!`](/api/reference/objects/candidate-note-connection) `non-null` `object` [#timeline-notes]
The notes on their timeline: the note written for a client share first, then the newest by when it was written. A note about a job they are not yet released on is left out.
##### [`Candidate.timelineNotes.after`](#candidate-timeline-notes-after) · [`String`](/api/reference/scalars/string) `scalar` [#candidate-timeline-notes-after]
Return the rows that follow this cursor.

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

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

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

#### [`Candidate.touches`](#touches) · [`TouchConnection!`](/api/reference/objects/touch-connection) `non-null` `object` [#touches]
Every message, call and meeting recorded with them as a candidate, newest recorded first.
##### [`Candidate.touches.after`](#candidate-touches-after) · [`String`](/api/reference/scalars/string) `scalar` [#candidate-touches-after]
Return the rows that follow this cursor.

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

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

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

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

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

### Returned By [#returned-by]

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

### Member Of [#member-of]

[`AddedCandidate`](/api/reference/objects/added-candidate)  `object` · [`AttachCandidateDocumentPayload`](/api/reference/objects/attach-candidate-document-payload)  `object` · [`AttachUnmatchedCallPayload`](/api/reference/objects/attach-unmatched-call-payload)  `object` · [`AttachUnmatchedCallToNewCandidatePayload`](/api/reference/objects/attach-unmatched-call-to-new-candidate-payload)  `object` · [`AuditEntry`](/api/reference/objects/audit-entry)  `object` · [`CallAction`](/api/reference/objects/call-action)  `object` · [`CallLink`](/api/reference/objects/call-link)  `object` · [`CallRoleCheck`](/api/reference/objects/call-role-check)  `object` · [`CandidateDocument`](/api/reference/objects/candidate-document)  `object` · [`CandidateEdge`](/api/reference/objects/candidate-edge)  `object` · [`CandidateEmployment`](/api/reference/objects/candidate-employment)  `object` · [`CandidateFact`](/api/reference/objects/candidate-fact)  `object` · [`CandidateNote`](/api/reference/objects/candidate-note)  `object` · [`CandidateRelationship`](/api/reference/objects/candidate-relationship)  `object` · [`JobCandidate`](/api/reference/objects/job-candidate)  `object` · [`Presentation`](/api/reference/objects/presentation)  `object` · [`RelationshipSignal`](/api/reference/objects/relationship-signal)  `object` · [`SetCandidatePersonPayload`](/api/reference/objects/set-candidate-person-payload)  `object` · [`Touch`](/api/reference/objects/touch)  `object` · [`UnlinkCallFromCandidatePayload`](/api/reference/objects/unlink-call-from-candidate-payload)  `object` · [`UnmatchedCall`](/api/reference/objects/unmatched-call)  `object`

## Shown in the UI [#shown-in-the-ui]

These components show it:

- [Review card](/ui/candidate-review-card): One person against a role, with your actions.
- [Inline card](/ui/candidate-inline-card): A compact candidate row for lists and messages.
- [Profile](/ui/candidate-profile): Identity, career history and contact channels.
- [Profile dialog](/ui/candidate-profile-dialog): A profile in a dialog, or a drawer on a phone.
- [Cover header](/ui/candidate-cover-header): A cover and an identity, as cards and profiles share them.