Get background check details

get

https://api.hibob.com/v1/hiring/background-checks/{backgroundCheckRequestId}

Fetch candidate, requester, job opening, and package context for a triggered background check.

Returns full check context after the partner receives a
backgroundCheck.triggered webhook. Partners fetch details before starting
processing at the provider — outbound events carry IDs only; candidate PII
is available only on this authenticated GET.

The response is company-scoped to the installing tenant and the partner
provider resolved from the OAuth app. Returns 404 when the check does not
belong to that company/provider.

Bob always returns the same fixed field set. Collecting any additional
provider-required input (for example SSN, date of birth, or consent) is the
partner's responsibility in their own flow.

OAuth scope: hiring.integrations:write

Responses

200Success

400Bad request — the request body failed validation (for example an unsupported status, blank package id/name, or duplicate package IDs in the same catalog push).

401Unauthorized — the OAuth 2.0 access token is missing, invalid, or expired.

403Forbidden — the authenticated partner app does not have the hiring.integrations:write scope, or the background-check integration is not enabled for the installing company.

404Not found — no background check exists for the given backgroundCheckRequestId in the installing company for this partner provider.

429Too many requests — rate limit exceeded. Retry after the delay indicated by the platform partner API / API gateway defaults.

500Internal server error — an unexpected error occurred. Retry with exponential backoff; if the error persists, contact HiBob support with the requestId from the response body.