GRgreenhouse
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 a response_status reflecting the calendar RSVP and a scorecard_id that is set once a scorecard is submitted for that interviewer. A row with a user_id and an empty scorecard_id has no submitted feedback yet; it is only owed once the interview's status is awaiting_feedback or received. 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

Request

  • Base URL
    https://harvest.greenhouse.io
  • URL
    https://harvest.greenhouse.io/v3/interviewers
  • Auth
    • OAuth 2
      Authorization code: https://auth.greenhouse.io/authorize
      Client credentials
      Token URL: https://auth.greenhouse.io/token scopes: harvest:interviewers:list
    • or HTTP bearer

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 submitted scorecard recorded for this panel member on this interview. Greenhouse sets it when the scorecard is submitted, including when an admin submits on the interviewer's behalf (submitter_id then identifies the admin); draft scorecards never populate it. null means no scorecard has been submitted for this panel member on this interview. External attendees without a Greenhouse user never submit one.

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.

Changes

No recorded changes to this operation across all 1 revision of this API.