Skip to content

Create an adverse action

Request

Finalizes an adverse decision against the subject identified by check_id. Use this when your organization is declining a subject based in whole or in part on the results of a Checkr Trust background check.

Delivers the required adverse action notice to the subject so they can seek assistance or initiate a dispute. In the event a dispute is resolved with changes to the report, Checkr Trust will notify your organization so you can reassess the subject's eligibility.

May be submitted with or without a prior pre-adverse action.

Including disqualifying_records is optional but strongly recommended — FCRA requires disclosing which records triggered the adverse decision.

Security
get-bearer-token-using-oauth2
Bodyapplication/jsonrequired
check_idstring, (uuid)(uuid)required

The ID of the regulated check that produced the records for this adverse action.

Example:"2b8313e8-4efd-45a1-b578-952b8313e890"
emailstring, (email)(email_string)required

Email address of the subject to deliver the notice to.

Example:"john.doe@example.com"
suppress_noticeboolean

When true, the notice email is not sent to the subject. The candidate_report_url is still populated in the response. Defaults to false.

Default:false
disqualifying_recordsArray of objects(disqualifying_record)

The criminal records that triggered the adverse decision. Optional but recommended.

Example:
[
  {
    "record_id": "record-7480fc7edac1a09867849999f2a2f6eec3cc37150f4ba65cbd1f46a4a1a5c15e"
  }
]
POST
/regulated/adverse_actions
curl -i -X POST \
  https://api.checkrtrust.com/v1/regulated/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"
      }
    ]
  }'

Responses

Created

Bodyapplication/json
idstring, (uuid)(uuid)

A universally unique identifier (UUID) in standard format.

Example:"2b8313e8-4efd-45a1-b578-952b8313e890"
check_idstring, (uuid)(uuid)

The ID of the regulated check that produced the records for this adverse action.

Example:"2b8313e8-4efd-45a1-b578-952b8313e890"
statusstring

The status associated with the adverse action.

Example:"AdverseActionInitiated"
candidate_report_urlstring or null, (uri)

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 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).

Example:"https://subjects.checkrtrust.com/2b8313e8-4efd-45a1-b578-952b8313e890/review"
disqualifying_recordsArray of objects(disqualifying_record)
created_atstring, (date-time)(datetime)

An ISO 8601 formatted date-time string.

Example:"2020-01-01T00:00:00Z"
sent_atstring or null, (date-time)

Timestamp when the notice was delivered. Null until status is sent.

Example:"2024-06-01T14:00:00Z"
Response
{
  "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"
}

Callbacks

Adverse Action Dispute Filed Webhook
post
Adverse Action Dispute Resolved Webhook
post