List interviews

get

https://harvest.greenhouse.io/v3/interviews

Interviews are scheduled interview events on a candidate's application — each row pairs an application with a slot on the job's interview plan (the job_interview) and carries the start/end time, location, organizer, video conferencing link, and lifecycle status. Scope the list with parent=application|job|job_interview|organizer plus ids to pull interviews for one or more candidates, jobs, interview slots, or scheduling coordinators. Use the starts_at / ends_at filters for time-bounded interviews; use all_day_start_on / all_day_end_on for all-day events (e.g. take-home tests). Lookup by external calendar event id is supported via external_event_id.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Query Params

cursor

string

Cursor link for pagination from previous page response header. Do not use any other parameters when using this.

per_page

integer

1 to 500

Defaults to 100

Number of results per page

ids

array of integers

length ≤ 50

Comma separated list

ids

created_at

object

updated_at

object

job_ids

array of integers

length ≤ 50

Return only interviews scheduled for applications on these job (hiring plan) ids.

job_ids

application_ids

array of integers

length ≤ 50

Comma separated list

application_ids

job_interview_ids

array of integers

length ≤ 50

Return only interviews scheduled against these job_interview ids. A job_interview is the stage's interview configuration (template) on an interview kit, not the scheduled interview itself — fetch ids via GET /v3/job_interviews.

job_interview_ids

organizer_ids

array of integers

length ≤ 50

Return only interviews organized by these Greenhouse user ids. The organizer is the calendar role responsible for scheduling the interview, not an interviewer on the panel.

organizer_ids

fields

array of strings

length ≤ 50

Comma separated list of fields to return

fields

starts_at

object

Filter by interview start time. Pass any combination of gte, lte, gt, lt as ISO-8601 date-times (e.g. starts_at[gte]=2026-01-01T00:00:00Z&starts_at[lte]=2026-02-01T00:00:00Z). Interviews with a null starts_at are excluded by this filter.

ends_at

object

Filter by interview end time. Pass any combination of gte, lte, gt, lt as ISO-8601 date-times. Interviews with a null ends_at are excluded by this filter.

all_day_start_on

object

Filter all-day interviews by start date (YYYY-MM-DD). Accepts gte, lte, gt, lt. Only matches interviews whose underlying calendar event is all-day; use starts_at for time-bounded interviews.

all_day_end_on

object

Filter all-day interviews by end date (YYYY-MM-DD). Accepts gte, lte, gt, lt. Only matches interviews whose underlying calendar event is all-day.

external_event_id

string

Return the interview tied to this external calendar event id (e.g. a Google Calendar or Outlook event id). Useful for round-tripping from a calendar webhook back to the Greenhouse interview.

status

string

enum

Filter by interview lifecycle status. scheduled is on the calendar; awaiting_feedback is past with scorecards outstanding; complete is past with all scorecards in; to_be_scheduled is the pre-schedule placeholder. Take-home test interviews use to_be_sent, sent, and received.

Response

200Successful