Regulated County Checks provide county-level or statewide criminal background check results for a specific jurisdiction. county_fips_code is required. Provide a 5-digit FIPS code for a county-level search, or the literal statewide for a state-level search. Results include checks at the record, case, and charge levels indicating compliance with applicable legal rules. A permissible purpose is required for FCRA compliance.
Create a new regulated county criminal check for a specific jurisdiction.
This endpoint initiates a county-level or statewide criminal background check using either provided PII (personally identifiable information) or an existing profile. 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.
county_fips_code is required along with the state: provide a 5-digit FIPS code for a county-level check, or the literal statewide for a state-level check.
Profile vs inline PII: Submit either a profile_id or inline PII/address fields—not both. Combining profile_id with name fields, addresses, or other PII returns 400 Bad Request. reference_id may be sent alongside profile_id. Empty addresses: [] counts as a supplied address parameter and cannot be paired with profile_id.
Required fields when providing PII (without profile_id):
- first_name
- last_name
- dob
- state
- county_fips_code
- filter_context
- permissible_purpose
When using a profile_id, state, county_fips_code, filter_context, and permissible_purpose are required.
Request optional response fields. Repeat the parameter for multiple values.
| Items Enum Value | Description |
|---|---|
| profile | Embeds the full profile object in place of |
| review | Embeds the regulated check review object (accept/decline/dispute status). |
The request body for creating a regulated county check
Request to create a regulated county check using personally identifiable information (PII). Set county_fips_code to the literal statewide to perform a state-level search instead of a county-level search. A permissible purpose must be provided to comply with FCRA requirements.
Provide first_name and last_name (without full_name).
- regulated_county_check_request_from_pii
- regulated_county_check_request_from_profile
curl -i -X POST \
'https://api.checkrtrust.com/v1/regulated/county_checks?include%5B%5D=profile' \
-H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
-H 'Content-Type: application/json' \
-d '{
"first_name": "Jane",
"middle_name": "Mary",
"last_name": "Smith",
"dob": "19900115",
"state": "CA",
"county_fips_code": "06075",
"filter_context": {
"candidate_jurisdiction": {
"state": "CA"
},
"decider_jurisdiction": {
"state": "NY"
}
},
"permissible_purpose": "Employment"
}'Created
A regulated county criminal check response.
A universally unique identifier (UUID) in standard format.
An ISO 8601 formatted date-time string.
An ISO 8601 formatted date-time string.
The type of regulated county check.
The current status of the regulated county check.
pending— the check has been submitted and is awaiting results.complete— results are available.cancelled— the search was cancelled, either at your request or because it could not be completed. When a search cannot be completed, acounty_check.not_availablewebhook is delivered.
A machine-readable reason for a check's error status. Only present when the check has errored.
provider_error— the third-party data provider returned an unrecoverable error.timeout— the check did not complete within the allowed time window.cancelled— the check was cancelled, either at your request or because it could not be completed.need_more_info— additional identity information (e.g. email or SSN) is required to view results.
A reference identifier for linking related records. Limited to 64 alphanumeric characters, underscores, and hyphens.
The search criteria used for the regulated county check.
The results of the regulated county check. Empty array if no records found or if the check is still pending.
An unstructured array of human-readable notes about this particular check. May contain notes about how input was parsed or other information about results. Not intended to be parsed by computer, as these notes are not guaranteed to be in any given format.
[ "used no ruleset" ]
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.
- regulated county check with profile id
- regulated county check with profile object
{ "profile_id": "2b8313e8-4efd-45a1-b578-952b8313e890" }