---
title: "List interviewers"
method: GET
path: "/v3/interviewers"
tags: ["Interviewers"]
---

# List interviewers

`GET /v3/interviewers`

Interviewers are the panel members on actual scheduled interviews — each row pairs one interview with one user (or, for external attendees, one email address). When an interview is scheduled, the stage's default interviewers seed this panel, but the final attendee list can differ once the calendar event is built and edited. Each row carries its own `scorecard_id` (one placeholder scorecard per assigned interviewer) and a `response_status` reflecting the calendar RSVP. Filter to one parent with `parent=interview`, `parent=user`, or `parent=scorecard` plus `ids`. For the per-stage default panel, see `/v3/default_interviewers` instead.

## 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
- `interview_ids` integer[]
- `user_ids` integer[]
- `scorecard_ids` integer[]
- `fields` string[]
- `response_status` 'needs_action' | 'declined' | 'tentative' | 'accepted'

## Response `200`

Successful

- object[]
  - `id` integer
  - `created_at` string, date-time
  - `updated_at` string, date-time
  - `interview_id` integer — Id of the scheduled interview this row belongs to. References a `/v3/interviews` row; the same interview appears once per panel member.
  - `user_id` integer, nullable — Id of the Greenhouse user on the panel. References a `/v3/users` row. `null` when the panel member is an external attendee on the underlying calendar event whose email does not match a Greenhouse user — in that case the address surfaces in `email`.
  - `scorecard_id` integer, nullable — Id of the scorecard assigned to this panel member for this interview. Scorecards are one-to-one with interviewer rows: when an interview is scheduled, Greenhouse creates a placeholder scorecard per assigned interviewer that the same user later fills out. `null` for panel members who do not get a scorecard (typically the calendar organizer or external attendees without a Greenhouse user).
  - `email` string, nullable — Email address used to identify this panel member. When `user_id` is set, this returns the user's primary Greenhouse email; for external attendees without a Greenhouse user, this is the raw calendar invitee address. `null` only when neither is available.
  - `response_status` 'needs_action' | 'declined' | 'tentative' | 'accepted', nullable — Panel member's RSVP on the calendar invite. `needs_action` is the default until the invitee responds; `accepted`, `tentative`, and `declined` mirror the calendar response. For Outlook 365 customers, accept/decline only syncs back after the interview is updated in Greenhouse or the external event is re-edited.

---

[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)