Order a background check

Orders a background-check package for the candidate. The fl_registry_hire package bundles: national sex-offender registry search, OIG/LEIE exclusion check, Florida license verification, and reference checks.

Requires consent.fcra_disclosure: true on the candidate (set at ingest or via PATCH-less re-ingest is not supported — capture it at ingest); orders without it are rejected with 409 conflict_error (code: fcra_disclosure_required).

FL AHCA Level 2 / Clearinghouse: where a package includes Level 2 screening, CONFIRM tracks orchestration status only (initiated, screening_in_progress, determination_received). Results flow legally to AHCA and the provider — never through CONFIRM.

Results in checks[] are eligibility-style determinations (eligible / review), not raw records, consistent with FCRA. Partners must make final FCRA adverse-action decisions through their own compliant process; this section is a draft pending legal review.

Orders a background-check package for the candidate. The `fl_registry_hire` package bundles: national sex-offender registry search, OIG/LEIE exclusion check, Florida license verification, and reference checks. Requires `consent.fcra_disclosure: true` on the candidate (set at ingest or via PATCH-less re-ingest is not supported — capture it at ingest); orders without it are rejected with `409 conflict_error` (`code: fcra_disclosure_required`). **FL AHCA Level 2 / Clearinghouse:** where a package includes Level 2 screening, CONFIRM tracks orchestration **status only** (`initiated`, `screening_in_progress`, `determination_received`). Results flow legally to AHCA and the provider — never through CONFIRM. Results in `checks[]` are eligibility-style determinations (`eligible` / `review`), not raw records, consistent with FCRA. Partners must make final FCRA adverse-action decisions through their own compliant process; this section is a draft pending legal review.

Authentication

AuthorizationBearer

Partner API key sent as Authorization: Bearer cfk_.... Keys are partner-level — one key reaches every registry linked to your partner account and nothing else. CONFIRM issues and revokes them; a key is shown exactly once at creation because only its hash is stored, and revocation takes effect on the next request. Develop against the sandbox base URL with a sandbox key, where telephony is restricted to an allowlist you provide.

Partner API key sent as `Authorization: Bearer cfk_...`. Keys are partner-level — one key reaches every registry linked to your partner account and nothing else. CONFIRM issues and revokes them; a key is shown exactly once at creation because only its hash is stored, and revocation takes effect on the next request. Develop against the sandbox base URL with a sandbox key, where telephony is restricted to an allowlist you provide.

Path parameters

org_idstringRequired

Organization ID (org_...).

cand_idstringRequired

Candidate ID (cand_...).

Request

This endpoint expects an object.

packageenumRequired

Background-check package to order. fl_registry_hire = national sex-offender registry + OIG/LEIE exclusion + FL license verification + reference checks.

Allowed values:

Response

Background check ordered.

idstringOptional

Background check ID (bgc_...).

candidate_idstringOptional

external_refstring or nullOptional

The candidate’s external_ref, echoed for correlation.

packageenumOptional

statusenumOptional

Order lifecycle: ordered → in_progress → completed or action_required.

checkslist of objectsOptional

ordered_atdatetimeOptional

completed_atdatetime or nullOptional

Errors

400

Bad Request Error

401

Unauthorized Error

404

Not Found Error

409

Conflict Error

429

Too Many Requests Error

$	curl -X POST https://api.confirm.global/partner/v1/organizations/org_4Nv8sJqKfH/candidates/cand_5DkW9rTzPe/background-checks \
>	-H "Authorization: Bearer <token>" \
>	-H "Content-Type: application/json" \
>	-d '{
>	"package": "fl_registry_hire"
>	}'

1	{
2	"id": "bgc_8XwT2nVqLm",
3	"candidate_id": "cand_5DkW9rTzPe",
4	"external_ref": "cl_app_84321",
5	"package": "fl_registry_hire",
6	"status": "ordered",
7	"checks": [
8	{
9	"type": "sex_offender_registry",
10	"status": "pending",
11	"result": "eligible",
12	"clearinghouse_status": "initiated"
13	}
14	],
15	"ordered_at": "2024-01-15T09:30:00Z",
16	"completed_at": "2024-01-15T09:30:00Z"
17	}

Authentication

Path parameters

Headers

Request

Response

Errors