HIhibob
Background checks

Get background check details

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

Rate limit: 60 calls per minute

get/hiring/background-checks/{backgroundCheckRequestId}

Request

  • Base URL
    https://api.hibob.com/v1
  • URL
    https://api.hibob.com/v1/hiring/background-checks/{backgroundCheckRequestId}
  • Auth
    HTTP bearer

Path parameters

backgroundCheckRequestIdstring required

Numeric Bob background-check ID as a string (same value as data.backgroundCheckRequestId on outbound webhooks).

Response

Success

backgroundCheckRequestIdstring required

Unique identifier of the background check in Bob. Matches the path parameter and webhook data.backgroundCheckRequestId.

packageIdstring required

Package selected by the recruiter when ordering the check.

requestedAtstring date-time required

When the check was requested in Bob, as an ISO 8601 timestamp with Z suffix (for example "2026-05-28T10:00:00Z").

Changes

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