Sign in

v1

latestOpenAPI 3.1.02026-07-261770816.7 KB
Interviewers

List 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.

get/v3/interviewers

Query parameters

cursorstring

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

per_pageinteger

Number of results per page

idsinteger[]

Comma separated list

gtestring date-time
ltestring date-time
gtstring date-time
ltstring date-time
gtestring date-time
ltestring date-time
gtstring date-time
ltstring date-time
interview_idsinteger[]

Comma separated list

user_idsinteger[]

Return only interviewer rows for these Greenhouse user ids (the users serving on the panel).

scorecard_idsinteger[]

Comma separated list

fieldsstring[]

Comma separated list of fields to return

response_status'needs_action' | 'declined' | 'tentative' | 'accepted'

Filter by the panel member's calendar RSVP. needs_action is the default until the invitee responds; accepted, tentative, and declined mirror the calendar response.

Response

Successful

idinteger
created_atstring date-time
updated_atstring date-time
interview_idinteger

Id of the scheduled interview this row belongs to. References a /v3/interviews row; the same interview appears once per panel member.

user_idinteger 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_idinteger 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).

emailstring 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.