---
title: "List job interviews"
method: GET
path: "/v3/job_interviews"
tags: ["Job Interviews"]
---

# List job interviews

`GET /v3/job_interviews`

Job interviews are the interview slots configured on a job's interview plan — the template definitions that say, for example, "this job's Onsite stage has a 30-minute recruiter chat, a 45-minute hiring manager interview, and a take-home test." Each slot belongs to a `job_interview_stage` on a specific job and carries the default name, duration, scheduling type, and scorecard requirement. When a candidate reaches the stage, individual `interviews` are spun up from these slots and scheduled against the candidate's application — the `id` returned here is the `job_interview_id` you pass to the Create Interview endpoint. Scope the list with `parent=job|job_interview_stage` plus `ids` to pull the slots for one or more jobs or stages. `summary` and `instructions` reflect the slot's defaults at the time it was added to the job and do not stay in sync with later edits made to the interview's Interview Prep — use the Interview Kits endpoint for the live values.

## Query parameters

- `cursor` string
- `per_page` integer
- `ids` integer[]
- `created_at` object
  - `gte` string, date-time
  - `lte` string, date-time
  - `gt` string, date-time
  - `lt` string, date-time
- `updated_at` object
  - `gte` string, date-time
  - `lte` string, date-time
  - `gt` string, date-time
  - `lt` string, date-time
- `job_interview_stage_ids` integer[]
- `job_ids` integer[]
- `fields` string[]
- `active` boolean
- `scheduling_type` 'none' | 'needs_scheduling' | 'take_home_test' | 'offer'

## Response `200`

Successful

- object[]
  - `id` integer
  - `created_at` string, date-time
  - `updated_at` string, date-time
  - `job_interview_stage_id` integer — Id of the `job_interview_stage` this slot belongs to (the section of the job's interview plan, e.g. "Onsite").
  - `job_id` integer — Id of the job whose interview plan this slot is defined on.
  - `sort_order` integer — Position of this slot within its `job_interview_stage`, ascending. The first interview in the stage is `1`.
  - `scheduling_type` 'none' | 'needs_scheduling' | 'take_home_test' | 'offer' | 'null', nullable — How the slot is fulfilled when a candidate hits the stage. `needs_scheduling` is a calendared interview that coordinators book against candidate availability; `take_home_test` is an asynchronous test sent through Greenhouse; `offer` is the offer step; `none` is a feedback-only slot (no scheduling). `null` for legacy steps with no scheduling type set.
  - `duration` integer, nullable — Default length of the interview in minutes, used to seed the scheduler. `null` if not set on the slot.
  - `summary` string, nullable — Candidate-facing summary copied from the interview's default Interview Prep when the slot was added to the job. Snapshot only — edits made later in the job's Interview Kit are not reflected here; use the Interview Kits endpoint for the live value.
  - `instructions` string, nullable — Interviewer-facing instructions copied from the interview's default Interview Prep when the slot was added to the job. Snapshot only — edits made later in the job's Interview Kit are not reflected here; use the Interview Kits endpoint for the live value.
  - `name` string — Name of the interview slot as it appears on the job's interview plan (e.g. "Recruiter Phone Screen", "Hiring Manager Interview").
  - `active` boolean — Whether the slot is on the job's current interview plan. Inactive slots are retained for historical interviews that were scheduled against them but are not used for new applications.
  - `require_scorecard` boolean, nullable — Whether interviewers must submit a scorecard for interviews scheduled against this slot. Only meaningful for `needs_scheduling` and `take_home_test` slots; `null` for `none` and `offer` slots, which never collect scorecards.

---

[API](https://skmtc.dev/greenhouse/apis/auth-api.md) · [All operations](https://skmtc.dev/greenhouse/apis/auth-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/greenhouse/auth-api/revisions/9517a2e54640/schema)