# County Checks

County Checks provide county-level criminal background check results for a specific jurisdiction. Results are retrieved from county court records and can be cancelled while in pending status.

## Create county check

 - [POST /county_checks](https://docs.checkrtrust.com/v1/county-checks/post-county-checks.md): Create a new county criminal check for a county jurisdiction, or a state-level criminal check when
county_fips_code is the literal statewide (case-insensitively).

This endpoint supports three mutually exclusive search modes:

{% partial file="/_partials/profile-id-county-precedence.md" /%}

PII search — provide subject identifying information directly:
- first_name (required)
- last_name (required)
- dob (required)
- state (required)
- county_fips_code (required) — 5-digit county FIPS, or statewide for a state-level search

Profile search — reference an existing profile:
- profile_id (required)
- state (required)
- county_fips_code (required) — 5-digit county FIPS, or statewide for a state-level search

Case number search — search by a specific court case number (only available for supported jurisdictions):
- case_number (required) — letters, numbers, spaces, and hyphens only
- state (required)
- county_fips_code (required) — 5-digit county FIPS, or statewide for a state-level search
- dob (optional)

These three modes are mutually exclusive — do not combine case_number with first_name/last_name or profile_id in the same request.

## Get county check

 - [GET /county_checks/{county_check_id}](https://docs.checkrtrust.com/v1/county-checks/get-county-check-by-id.md): Get a single county check with a given id.

## Cancel county check

 - [POST /county_checks/{county_check_id}/cancel](https://docs.checkrtrust.com/v1/county-checks/post-county-check-cancel.md): Cancel an existing county check that is in a pending state.

A reason must be provided for the cancellation. Only checks that are
currently in 'pending' status can be cancelled.