Create a new regulated criminal background check with legal annotation.
This endpoint performs an instant criminal check and applies legal rules based on the provided jurisdiction context. Results include legal annotation checks at the record, case, and charge levels indicating whether items should be included, investigated, or removed based on applicable regulations.
A permissible purpose must be provided to comply with FCRA requirements.
Profile vs inline PII: Submit either a profile_id or inline PII—not both. Regulated instant checks accept addresses[] only (not the singular address field). Combining profile_id with inline PII or addresses returns 400 Bad Request. Singular address is not supported—use addresses[].
Request optional response fields. Repeat the parameter for multiple values.
| Items Enum Value | Description |
|---|---|
| profile | Embeds the full profile object in place of |
| rulesets_applied | Embeds the rulesets applied when filtering this check's results. |
| review | Embeds the regulated check review object (accept/decline/dispute status). |
The request body for creating a new regulated check with legal annotation.
Use either inline PII (addresses[] only) or profile_id—not both. See the POST /regulated/checks operation for details.
Request to create a regulated check using personally identifiable information (PII).
Set to true to declare that the subject does not have a middle name.
Mutually exclusive with a non-empty middle_name: the API rejects requests that supply both a present middle_name and no_middle_name: true. An empty or null middle_name with no_middle_name: true is allowed. A non-empty middle_name may be supplied with no_middle_name: false.
Allowed with full_name: full_name and no_middle_name may be sent together. That is not the same as supplying middle_name — when the flag is true, parsing stores only a first name and surname, and any token the parser would have treated as a middle name is folded into the last name (for example full_name: "John Quincy Doe" becomes first name John and last name Quincy Doe, with middle_name empty).
Setting this to true clears a middle name already stored on a referenced profile. Supplying a non-empty middle_name without this field sets no_middle_name to false. When true, products that perform criminal-record identity matching exclude records with a middle name, narrowing matches to subjects with no middle name on record. When supplied with profile_id, the value is persisted to the referenced profile (same account-scoped profile the check is created against). Leave as false (or omit) if unsure.
The type of regulated check. Currently only instant_criminal_regulated is supported.
Either send the full name, or first, middle (optional), and last names, but not both. If you send a full name, we will attempt to parse it into first name, middle name(s) and last name. With no_middle_name: true, any parsed middle token is folded into the last name instead of being stored as a middle name.
Date of birth in the form YYYYMMDD. Must be a valid date and cannot be in the future. If invalid, the API returns a 400 with a validation_error pointing to /dob.
Social Security Number used for additional identity verification and record matching
A phone number in the form +[country code][number including area code]. (E.164 format). Please note that U.S. phone numbers have a country code of "1" so all U.S. phone numbers ought to start with "+1". A U.S. number supplied in national format (for example "(415) 555-0123") is normalized to E.164 on write. If the value cannot be parsed as a valid phone number, the API returns a 400 with a validation_error.
An array of addresses to search for criminal records. Index 0 is the primary address.
On inline create, addresses are saved to the new profile.
[ { "street": "456 Oak Ave", "city": "Los Angeles", "state": "CA", "zip_code": "90001" } ]
Context information used to determine which legal rules apply when filtering check results. Jurisdictions help identify applicable state and local regulations that may affect which records can be reported.
{ "candidate_jurisdiction": { "state": "CA" }, "decider_jurisdiction": { "state": "NY" } }
The permissible purpose for requesting this criminal record check, as required by the Fair Credit Reporting Act (FCRA). This must be provided for all regulated instant criminal checks to ensure compliance with federal regulations.
Identifier of an existing ruleset containing filtering rules. To set up account rulesets, please reach out to your Checkr Account Executive or Customer Success representative to set up the configuration.
A list of ruleset identifiers to apply. When both ruleset_id and ruleset_ids are provided, they are merged and de-duplicated before applying.
A reference identifier for linking related records. Limited to 64 alphanumeric characters, underscores, and hyphens.
An array of state abbreviations. Only records which come from a given source state are included in the results. Note that some sources are not tagged as coming from a single source state, so records from those sources will always be included. Sex offender registry records and most watchlist records are not tagged with a source state, and so will appear in the results regardless of this flag.
- Checkr Trust APIhttps://api.checkrtrust.com/v1/regulated/checks
curl -i -X POST \
'https://api.checkrtrust.com/v1/regulated/checks?include%5B%5D=profile' \
-H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
-H 'Content-Type: application/json' \
-d '{
"first_name": "JOHN",
"last_name": "SMITH",
"dob": "19900101",
"ssn": "123-45-6789",
"phone": "+14155552671",
"addresses": [
{
"street": "456 Oak Ave",
"city": "Los Angeles",
"state": "CA",
"zip_code": "90001"
}
],
"filter_context": {
"candidate_jurisdiction": {
"state": "CA"
},
"decider_jurisdiction": {
"state": "NY"
}
},
"permissible_purpose": "Employment"
}'Created. When the product has usage limits configured, the response includes X-RateLimit-Limit, X-RateLimit-Remaining, and optionally X-RateLimit-Expires.
A regulated check response with legal annotation checks included in results.
A universally unique identifier (UUID) in standard format.
An ISO 8601 formatted date-time string.
An ISO 8601 formatted date-time string.
The fully-disclosed records found for this check. When there are no results found, this will be an empty array. A record excluded by legal rules never appears here -- see excluded_records.
Records excluded by legal rules, reduced to an identifier, classification, jurisdiction, and per-charge offense classification. Present only when the account's excluded_record_disclosure setting is stripped; omitted (or empty) otherwise, and always separate from results. Also omitted when include[]=results_found is requested, same as results itself.
The type of regulated check. Currently only instant_criminal_regulated is supported.
A reference identifier for linking related records. Limited to 64 alphanumeric characters, underscores, and hyphens.
An unstructured array of human-readable notes about this particular check. May contain notes about how input was parsed or other information about results.
Present only when include[]=results_found is requested; omitted otherwise. When present, the results array is omitted.
Present only when include[]=rulesets_applied is requested; omitted otherwise.
Customer accept/decline/dispute state for a regulated check.
Present only when include[]=review is requested; omitted otherwise. Indicates whether adverse-action workflow is enabled for this product.
{ "profile_id": "2b8313e8-4efd-45a1-b578-952b8313e890" }