Skip to main content
GET
List criteria

Authorizations

Authorization
string
header
required

API key authentication for the public API. Pass your API key as a Bearer token.

Path Parameters

job_id
string<uuid>
required

Response

id
string<uuid>
required
read-only
created_at
string<date-time>
required
read-only
updated_at
string<date-time>
required
read-only
name
string
required

Short label shown on the scorecard (e.g. 'Clinical judgment', 'Holds nursing license').

description
string
required

What this criterion evaluates. Role-specific and observable from the interview. For qualifications, the description must name the specific verifiable bar: the credential, license, work authorization, or numerical threshold the candidate must meet to pass.

kind
enum<string>
required

Competency: graded 1-5 against a behaviorally anchored rubric (uses weight). Qualification: pass/fail against the bar stated in description (weight ignored).

  • competency - Competency
  • qualification - Qualification
Available options:
competency,
qualification
sequence_number
integer | null
required
read-only
is_active
boolean
required
read-only

Inactive criteria are not used in interview scoring

required
boolean

If true, this criterion is a hard requirement. Failing it flags the candidate as ineligible regardless of other scores. For qualifications: failing = the bar in description not met. For competencies: failing = assessed score below minimum_score (if set), or criterion unassessable.

minimum_score
integer | null

[Competency only] Optional 1-5 threshold for required competencies. Candidate fails the hard requirement if the scored level is below this. Leave null to require the criterion be assessable without a specific floor. Must be null for qualifications.

Required range: 1 <= x <= 5
level_1_description
string

[Competency only] Level 1 - clear deficit. Would fail in the role. Required for competencies; must be blank for qualifications.

level_2_description
string

[Competency only] Level 2 - below expectations. Needs significant development. Required for competencies; must be blank for qualifications.

level_3_description
string

[Competency only] Level 3 - meets expectations. Solid hire for this role. Required for competencies; must be blank for qualifications.

level_4_description
string

[Competency only] Level 4 - exceeds expectations. Strong hire. Required for competencies; must be blank for qualifications.

level_5_description
string

[Competency only] Level 5 - exceptional. Stands out clearly. Required for competencies; must be blank for qualifications.

weight
string<decimal>

[Competency only] Relative importance of this competency in overall score calculation. Default is 1.0 (normal importance). Use 0.5 for nice-to-have, 1.5 for core skill. 0 means this criterion is not used for scoring.

Pattern: ^-?\d{0,3}(?:\.\d{0,2})?$