Regulated Adverse Action provides two separate endpoints for the FCRA adverse action flow: Pre-Adverse Action and Adverse Action.
Pre-Adverse Action notifies the subject of a pending adverse decision, delivers a copy of the report, and provides required FCRA disclosures — giving them an opportunity to dispute before a final decision is made. This step is optional but must precede a final adverse action if used.
Adverse Action finalizes the adverse decision and delivers the required notice to the subject. It may be submitted with or without a prior pre-adverse action.
Sends a pre-adverse action notification to the subject identified by check_id, giving them the opportunity to dispute the results of their background check before a final decision is made regarding their eligibility. This ensures compliance and fairness in the decision-making process.
This step is optional but must precede a final adverse action if used. Cannot be submitted after an adverse action has already been taken for this check.
The ID of the regulated check that produced the records for this pre-adverse action.
Email address of the subject to deliver the notice to.
When true, the notice email is not sent to the subject. The candidate_report_url is still populated in the response. Defaults to false.
curl -i -X POST \
https://api.checkrtrust.com/v1/regulated/pre_adverse_actions \
-H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
-H 'Content-Type: application/json' \
-d '{
"check_id": "a3f1e290-bc44-4d2a-9c18-d3e5f2a71b00",
"email": "john.smith@example.com",
"disqualifying_records": [
{
"record_id": "record-7480fc7edac1a09867849999f2a2f6eec3cc37150f4ba65cbd1f46a4a1a5c15e"
}
]
}'Created
A universally unique identifier (UUID) in standard format.
The ID of the regulated check that produced the records for this pre-adverse action.
Subject-facing URL for viewing the background check report and responding to the notice. When a subject UI is configured this is a deep link keyed by the pre-adverse action id, gated by a one-time code sent to the subject's email so the customer cannot open it directly; you may still share it with the subject, and Checkr emails it to them unless suppress_notice is set. Where no subject UI is configured, this is a support mailto: link instead (no OTP gating).
An ISO 8601 formatted date-time string.
{ "id": "2b8313e8-4efd-45a1-b578-952b8313e890", "check_id": "2b8313e8-4efd-45a1-b578-952b8313e890", "status": "AdverseActionInitiated", "candidate_report_url": "https://subjects.checkrtrust.com/2b8313e8-4efd-45a1-b578-952b8313e890/review", "disqualifying_records": [ { … } ], "created_at": "2020-01-01T00:00:00Z", "sent_at": "2024-06-01T14:00:00Z" }