GRgreenhouse
Scorecards

List scorecards

Scorecards are the per-interview evaluations that interviewers fill out: overall recommendation, key takeaways, private and public notes, and ratings on the interview kit's focus attributes. A complete scorecard is submitted feedback, with submitted_at set. A draft scorecard is an autosaved working copy, saved when someone starts a scorecard without submitting it or edits a submitted one. Drafts belong to the user who opened the form, are not shown as feedback in Greenhouse, and do not mean feedback is owed. To find feedback still owed, list /v3/interviewers for the interview and look for rows with a user_id and no scorecard_id on interviews whose status is awaiting_feedback or received; scheduled future interviews have no feedback due yet.

get/v3/scorecards

Request

  • Base URL
    https://harvest.greenhouse.io
  • URL
    https://harvest.greenhouse.io/v3/scorecards
  • Auth
    • OAuth 2
      Authorization code: https://auth.greenhouse.io/authorize
      Client credentials
      Token URL: https://auth.greenhouse.io/token scopes: harvest:scorecards: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_kit_idsinteger[]

Comma separated list

submitter_idsinteger[]

Comma separated list

application_idsinteger[]

Comma separated list

interviewer_idsinteger[]

Return only scorecards assigned to these interviewer user ids.

fieldsstring[]

Comma separated list of fields to return

gtestring date-time
ltestring date-time
gtstring date-time
ltstring date-time

Filter by interview timestamp on the scorecard. Pass any combination of gte, lte, gt, lt as ISO-8601 date-times (e.g. interviewed_at[gte]=2026-01-01T00:00:00Z&interviewed_at[lte]=2026-02-01T00:00:00Z).

gtestring date-time
ltestring date-time
gtstring date-time
ltstring date-time

Filter by submission timestamp. Pass any combination of gte, lte, gt, lt as ISO-8601 date-times. Only complete scorecards have a submitted_at; draft scorecards are excluded by this filter.

status'draft' | 'complete'

Filter by scorecard lifecycle status. complete returns submitted scorecards. draft returns autosaved working copies, not scorecards still owed. For outstanding feedback, use /v3/interviewers rows with no scorecard_id on interviews in awaiting_feedback or received status.

Response

Successful

idinteger
created_atstring date-time
updated_atstring date-time
interview_kit_idinteger

Id of the interview kit this scorecard was filled out against. The kit determines the questions, focus attributes, and rating scale on the scorecard. The kit also identifies which interview slot on the job's interview plan produced this scorecard.

interviewer_idinteger

Id of the Greenhouse user who participated in the interview and to whom this scorecard is assigned. Each interviewer on a multi-interviewer interview gets their own scorecard.

interviewed_atstring date-time nullable

Timestamp the interview took place, in ISO 8601. Mirrors the underlying interview's scheduled time and is set when the scorecard is created (manual scorecards may set this independently).

notesstring nullable

Free-text "key takeaways" the interviewer recorded on the scorecard (pros, cons, follow-ups). Plain text with @-mentions rendered as user names; use notes_with_tags for the version where mentions are tagged for downstream parsing.

notes_with_tagsstring nullable

notes with @-mentions rendered as embedded user tags (e.g. @[User Name](user:123)) instead of plain user names, for partners that need to resolve mentioned users.

submitter_idinteger

Id of the Greenhouse user who actually submitted the scorecard. Usually the same as interviewer_id, but differs when an admin submits a scorecard on another interviewer's behalf.

candidate_ratingstring

Interviewer's overall recommendation on whether the candidate passed the interview. One of strong_no ("Definitely Not" in the UI), no, yes, strong_yes, or no_decision. no_decision is recorded when the interviewer submitted the scorecard without choosing a recommendation.

private_notesstring nullable

Free-text private notes visible only to users with the "see private notes" permission. Plain text with @-mentions rendered as user names; use private_notes_with_tags for the tagged version.

private_notes_with_tagsstring nullable

private_notes with @-mentions rendered as embedded user tags instead of plain user names.

status'draft' | 'complete'

Lifecycle status of the scorecard. complete is submitted feedback (and submitted_at is set). draft is an autosaved working copy owned by the user who opened the form; it is not shown as feedback and does not mean feedback is owed. Only complete scorecards count toward interview completion and downstream analysis.

public_notesstring nullable

Free-text "note to other interviewers" the interviewer leaves for the rest of the hiring team. Plain text with @-mentions rendered as user names; use public_notes_with_tags for the tagged version.

public_notes_with_tagsstring nullable

public_notes with @-mentions rendered as embedded user tags instead of plain user names.

application_idinteger

Id of the application this scorecard belongs to. Use it to look up the candidate via the applications endpoint.

submitted_atstring date-time nullable

Timestamp the scorecard was submitted (moved from draft to complete), in ISO 8601. null while status is draft. The delta between interviewed_at and submitted_at is a common "time to submit scorecard" measure.

Changes

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