Indeed · Schema
Indeed Candidate
A candidate object from the Indeed Employer API, representing a job applicant who has applied to a position through Indeed or Indeed Apply. Contains personal details, resume, application status, and responses to screener and EEO questions.
CareersEmploymentHiringJob SearchJobsRecruiting
Properties
| Name | Type | Description |
|---|---|---|
| id | string | A unique candidate application identifier. For Indeed Apply applications, this is a 64-character string (apply_id) that uniquely connects the employer, candidate, and job posting. |
| name | string | The candidate's full name as provided in their application. |
| firstName | string | The candidate's first (given) name. |
| lastName | string | The candidate's last (family) name. |
| string | The candidate's email address. | |
| phoneNumber | string | The candidate's phone number, typically in E.164 or national format. |
| location | string | The candidate's location as a freeform text string, such as city and state. |
| resume | object | The candidate's resume in multiple formats. Not all formats are always available; use a robust parser that treats missing fields as empty. |
| coverLetter | string | The candidate's cover letter text, if provided with the application. |
| applicationStatus | string | The current disposition status of the candidate's application within the hiring pipeline. Must map to one of Indeed's six predefined categories. |
| screenerQuestionResponses | array | The candidate's responses to screener questions configured on the job posting. |
| eeoResponses | object | Equal Employment Opportunity (EEO) compliance responses provided by the candidate. Only available for US employers that have EEO questions enabled on their job postings. |
| appliedAt | string | The ISO 8601 timestamp when the candidate submitted their application. |
| source | string | The channel through which the candidate submitted their application, such as indeed_apply, organic, or other integration sources. |
| jobPostingId | string | The unique identifier of the job posting the candidate applied to. |
| jobTitle | string | The title of the job posting the candidate applied to. |
| employerId | string | The unique identifier of the employer who posted the job. |
| acknowledged | boolean | Whether this candidate application has been acknowledged by the ATS. Unacknowledged applications are returned first in Retrieve Candidates API queries. |
| updatedAt | string | The ISO 8601 timestamp when the candidate record was last updated. |