v1

latestOpenAPI 3.1.02026-07-261770816.7 KB
Scorecard Candidate Attributes

List scorecard candidate attributes

Scorecard candidate attributes are the per-scorecard ratings an interviewer captured on each focus attribute — what they thought of this candidate on each attribute on this scorecard. Each row pairs one scorecard with one job_candidate_attribute (the per-job attribute being rated) and carries the rating in candidate_attribute_rating plus an optional free-text note. Filter by scorecard_ids to pull every attribute rating on a given scorecard, or by job_candidate_attribute_ids to see how interviewers rated the same attribute across scorecards (the read pattern used by talent-matching and partner interview-intelligence integrations). Sibling to /v3/scorecard_question_candidate_attributes, which maps questions to attributes on the interview kit rather than capturing interviewer ratings.

get/v3/scorecard_candidate_attributes

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
scorecard_idsinteger[]

Comma separated list

job_candidate_attribute_idsinteger[]

Return only scorecard candidate attributes that rated these job candidate attribute ids. Job candidate attributes are the scoring rubric items registered on a job (the set of attributes scorecards can score against).

fieldsstring[]

Comma separated list of fields to return

Response

Successful

idinteger
created_atstring date-time
updated_atstring date-time
scorecard_idinteger

Id of the scorecard this attribute rating belongs to. One row per (scorecard, attribute) pair — the interviewer rated this candidate on this attribute on this scorecard.

candidate_attribute_ratingstring

Interviewer's rating for the attribute on this scorecard. One of definitely_not, no, yes, strong_yes, mixed, or no_decision. no_decision is recorded when the row exists (e.g. a note was left) but no rating was selected.

job_candidate_attribute_idinteger

Id of the job's job_candidate_attribute being rated (the per-job attribute catalogue entry on /v3/job_candidate_attributes). The attribute's display name and candidate_attribute_type live on that record.

notestring nullable

Free-text note the interviewer left for this attribute (e.g. a brief justification for the rating). null when no note was provided.