Job Roles

Get Job Role Benchmark

Per-role hiring benchmark — averages, top performer, and (when N is high enough) a top-quartile threshold based on the org's own completed interviews. Cold-start tier returned in tier so the UI can render the right state without re-implementing the gating.

Scoped to the caller's organization. Verifies role ownership before aggregating — never leaks data from another org through a guessed UUID.

get/api/job-roles/{job_role_id}/benchmark

Request

  • Base URL: https://api.thebetterhire.ai (the document declares no server; this is the origin it was published from)
  • URL: https://api.thebetterhire.ai/api/job-roles/{job_role_id}/benchmark
  • Auth: HTTP bearer

Path parameters

job_role_idstring uuid required

Response

Successful Response

ninteger required
tierstring required
overall_avgnumber nullable
top_quartile_thresholdnumber nullable
voided_countinteger

Changes

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