# Get regulated checks

Get a set of regulated instant criminal checks for the authenticated account.

Endpoint: GET /regulated/checks
Version: 1.0
Security: get-bearer-token-using-oauth2

## Security:

  - `get-bearer-token-using-oauth2` (unknown)
    oauth2

## Query parameters:

  - `limit` (integer)
    Limit the number of records returned

  - `skip` (integer)
    Skip a number of records before returning (for paging)

  - `include[]` (array)
    Request optional response fields. Repeat the parameter for multiple values.

## Response 200:

  - `200` (unknown)
    OK

## Response 200 fields (application/json):

  - `id` (string)
    A universally unique identifier (UUID) in standard format.
    Example: 2b8313e8-4efd-45a1-b578-952b8313e890

  - `created_at` (string)
    An ISO 8601 formatted date-time string.
    Example: 2020-01-01T00:00:00Z

  - `results` (array)
    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`.

  - `results.record_id` (string)
    An identifier for this record within the check result.
The same underlying record may share an ID across different checks. It is not a
permanent identifier: if the source data for a record changes, a later search may
return that record with a different ID.
    Example: record-7480fc7edac1a09867849999f2a2f6eec3cc37150f4ba65cbd1f46a4a1a5c15e

  - `results.category` (string)
    A categorization of the type of record returned.
Maps closely to the source category, except PA sources can contain either Patriot or Registry records.
    Enum: "arrest", "Criminal/traffic", "Warrant", "Sex Offender", "Patriot", "Registry"

  - `results.collection_date` (string)
    A date in the form YYYYMMDD.
    Example: 19950401

  - `results.collection_date_notice` (string)
    Disclaimer accompanying `collection_date` on Virginia records only: VA records may
have been sealed by the court since the date the record was collected. Only present
together with `collection_date`; when the date is omitted (no usable date), the
notice is omitted as well.
    Example: This information may include records that have been sealed since the collection date shown above.

  - `results.record_match_confidence_level` (string)
    **Record match confidence** for this record: how strongly this record aligns with the identity it was matched
to. Returned only for records sourced from Checkr's people data graph.
The values **high**, **medium**, and **low** are assigned based on Checkr's proprietary ML algorithm.
**Not comparable to other confidence fields.** This is measured independently from the case-level
`identity_match_confidence_level` (below) and, on Driver Risk Signals / Instant Criminal Profile, from the
profile-level `match_confidence_level`. The three answer different questions and are calibrated separately,
so a **high** on one does not mean the same thing as a **high** on another.
**Absence:** Omitted when the record's source does not supply a match confidence.
    Enum: "high", "medium", "low"

  - `results.person` (object)
    Person attributes as reported on this record. Only fields that have a value are returned;
most records include only a subset of these fields.

  - `results.person.first_name` (string)
    Example: John

  - `results.person.middle_name` (string)
    middle initial or name or names
    Example: W

  - `results.person.last_name` (string)
    Example: Smith

  - `results.person.suffix` (string)

  - `results.person.full_name` (string)
    Example: Smith, John W.

  - `results.person.dob` (string)
    A date or partial date in the form YYYYMMDD.
Since some dates are partial, they may be represented as YYYY0000 or 0000MMDD or YYYYMM00.
    Example: 19950401

  - `results.person.doc_number` (string)
    Dept. of Corrections number.
A number or identifier given by a state Dept. of Corrections to identify a person who went to prison.

  - `results.person.gender` (string)
    The gender, if any, as recorded by the source.  No specific format.
    Example: M

  - `results.person.height` (string)
    The height, if any, as recorded by the source.  No specific format.
    Example: 601

  - `results.person.weight` (string)
    The weight, if any, as recorded by the source.  No specific format.
    Example: 180

  - `results.person.hair_color` (string)
    The hair color, if any, as recorded by the source.  No specific format.
    Example: BRN

  - `results.person.eye_color` (string)
    The eye color if any, as recorded by the source.  No specific format.
    Example: HAZ

  - `results.person.skin_color` (string)
    The skin color, if any, as recorded by the source.  No specific format.
    Example: wht

  - `results.person.race` (string)
    The race as defined by the source.  No specific format.
    Example: W

  - `results.person.ethnicity` (string)
    The ethnicity, if any, as recorded by the source.  No specific format.
    Example: Hispanic-American

  - `results.person.physical_build` (string)
    The physical build, if any, as recorded by the source.  No specific format.
    Example: BROAD

  - `results.person.physical_marks` (string)
    Scars, marks, and tattoos as defined by the source.  No specific format.
    Example: blue cross on outside left ankle

  - `results.person.photo_urls` (array)
    A set of URLs referencing pictures of this person, as recorded by the source.

  - `results.person.name_aliases` (array)
    Other names that this person may have gone by.

  - `results.person.dob_aliases` (array)
    Other dates of birth that this person may have used.

  - `results.person.addresses` (array)
    Addresses associated with this person on this record, as reported by the data source.
Omitted when the source provides no address information. Each entry may be partial.
    Example: [{"street":"123 Main St","city":"Frankfort","state":"KY","zip_code":"40601"},{"street":"OFFENDER REPORTS MOVED OUT OF UTAH"}]

  - `results.person.addresses.street` (string)
    Street or location line as reported by the source. May be a free-form string rather than a
normalized postal address (for example, a registry status message).
    Example: 123 Main St

  - `results.person.addresses.city` (string)
    City or municipality when reported by the source.
    Example: Frankfort

  - `results.person.addresses.state` (string)
    State as reported by the source, if any.
    Example: KY

  - `results.person.addresses.zip_code` (string)
    ZIP code as reported by the source, if any.
    Example: 40601

  - `results.person.addresses.country` (string)
    Country as reported by the source, if any.
    Example: US

  - `results.source` (object)

  - `results.source.id` (string)
    An identifier for the source.  E.g. "cookil" or "NJ_Supreme_Ct_view".  Can be used to programmatically exclude a source.
    Example: ARSTfranklinKY

  - `results.source.category` (string)
    A categorization of the type of source where the data was retrieved.
Some of the categories may not imply wrongdoing, and are excluded by default.
    Enum: "arrest", "court", "criminal registry", "DOC", "warrant", "sex offender registry", "domestic watchlist", "foreign watchlist", "healthcare registry", "healthcare sanctions", "financial registry", "financial sanctions", "other registry", "other sanctions", "PEP registry"

  - `results.source.name` (string)
    A human-understandable (English) name of the source.
    Example: KY Franklin County Inmates

  - `results.source.county` (string)
    The name of the county (if any) where the record came from.
    Example: Franklin

  - `results.source.county_fips_code` (string)
    The 5-digit FIPS code of the county where the record came from.
Present for county checks; omitted for sources without an associated county.
    Example: 17031

  - `results.source.state` (string)
    A two-letter US state code.
    Example: CA

  - `results.cases` (array)
    Cases in this record, with legal annotation checks.

  - `results.cases.case_id` (string)
    A stable identifier for this case, derived from the case content.
Format: `case-{sha256_hash}`.
    Example: case-7480fc7edac1a09867849999f2a2f6eec3cc37150f4ba65cbd1f46a4a1a5c15e

  - `results.cases.case_number` (string)
    The case number assigned by a court.  Not present for records which are not from a court.  Format varies.
    Example: 2025-99999

  - `results.cases.type` (string)
    The case type as reported by the court.  Not present for records which are not from a court.  Format varies.

  - `results.cases.status` (string)
    The case status as reported by the court.  Sparsely available.  Format varies.

  - `results.cases.arresting_agency` (string)
    The name of the arresting agency.
    Example: Franklin County Sheriff

  - `results.cases.court_name` (string)
    The name of the charging court.
    Example: Franklin County Circuit Court

  - `results.cases.court_county` (string)
    The county of the charging court.
    Example: Franklin

  - `results.cases.identity_match_confidence_level` (string)
    **Identity match confidence** for this case. When present, it indicates how strongly this criminal case aligns
with the PII you submitted for the check.
Distinct from the record-level `record_match_confidence_level`: this field is about a single **case** versus the
PII you submitted, while that one is about a whole **record** versus the identity it was matched to. They are
measured separately and should not be compared to each other.
The values **high**, **medium**, and **low** are assigned based on Checkr's proprietary ML algorithm.
**Other values:** **unknown** — identity matching was enabled for the check but a confidence label could not be determined for this case. **insufficient_information** — identity matching was skipped (for example, insufficient identifiers); check `run_notes` for context.
**Absence:** This field may or may not be present. It is omitted when identity matching did not run for the check. For products that support identity matching, it runs automatically when the request includes first and last name plus a date of birth, phone, or SSN.
**Regulated Criminal Reports:** the field is returned only for cases where a match score is available, which requires enough identifying information in the request (first and last name plus a date of birth, phone, or SSN). It is omitted otherwise, and the `unknown` and `insufficient_information` values are not used, so do not depend on it being present on every case.
    Enum: "high", "medium", "low", "unknown", "insufficient_information"

  - `results.cases.charges` (array)
    Charges in this case, with legal annotation checks.

  - `results.cases.charges.charge_id` (string)
    A stable identifier for this charge, derived from the charge content.
Format: `charge-{sha256_hash}`.
    Example: charge-7480fc7edac1a09867849999f2a2f6eec3cc37150f4ba65cbd1f46a4a1a5c15e

  - `results.cases.charges.description` (string)
    The description of the offense, as reported on the record.  Format varies.
    Example: SHOPLIFTING

  - `results.cases.charges.legal_code` (string)
    Legal code (statute) as reported by the court or arresting agency.
    Example: 433.234

  - `results.cases.charges.type` (string)
    the type (level, severity) of a charge
    Enum: "felony", "misdemeanor", "petty_offense", "unknown"

  - `results.cases.charges.degree` (string)
    Court-reported offense degree, as written on the record.
    Example: MISDEMEANOR - CLASS B

  - `results.cases.charges.category` (string)
    the highest level of categorization of a charge
    Enum: "Criminal Intent", "Drugs & Alcohol", "Fraud & Deception", "Homicide", "Security", "Sexual", "Statutory", "Theft & Property", "Vehicles & Traffic", "Violence", "unclassified"

  - `results.cases.charges.subcategory` (string)
    the second level of categorization of a charge
    Enum: "Accessory", "Conspiracy", "Court Orders", "Criminal Tools", "Obstruction", "Organized Crime", "Alcohol & Tobacco", "Driving under the Influence (DUI)", "Drugs-Marijuana Possession/Use", "Drugs-Possession/Use", "Drugs-Sale & Manufacture", "Bribery & Corruption", "Business & Tax", "Cyber Crimes", "Embezzlement", "Forgery", "Fraud", "Identity Theft & Impersonation", "Worthless Check", "Attempted Homicide", "Intentional Homicide", "Unintentional Killing", "Immigration", "Terrorism", "Treason", "Lewd Behavior", "Prostitution", "Sexual Abuse", "Animal Ordinances", "Custody & Support", "Fish & Game", "Gambling", "Miscellaneous Citations & Violations", "Public Nuisance", "Safety & Zoning", "Arson", "Burglary", "Petty Theft", "Possession of Stolen Property", "Robbery", "Theft", "Trespassing", "Vandalism & Mischief", "License & Registration", "Parking", "Speeding", "Unsafe Operation", "Vehicle Equipment", "Abduction & Restraint", "Animal Cruelty", "Assault & Battery", "Child & Elder Abuse", "Disorderly Behavior", "Harassment & Threats", "Weapons & Endangerment", "unclassified"

  - `results.cases.charges.subsubcategory` (string)
    The lowest (most detailed) level of categorization of a charge.
There are over 250 of these.
They are one of the categorizations on which rulesets operate.
    Example: Retail Theft

  - `results.cases.charges.drug_group` (string)
    The substance group of a drug charge. Groups are by substance, not by activity: whether the
charge is use or trafficking is already carried by the category and subcategory.
**Not every charge can be classified.** Charges from some sources carry no classification to
group by, and those return **not calculated**. This is different from **not applicable**, which
means the charge was classified and is not a drug charge. Charges returned before this field was
introduced do not include it.
    Enum: "marijuana", "schedule I and II drug", "schedule III to V drug", "unspecified drug", "not applicable", "not calculated"

  - `results.cases.charges.city` (string)
    The name of the city where the person was charged
    Example: Indian Hills

  - `results.cases.charges.county` (string)
    The name of the county where the person was charged
    Example: Jefferson

  - `results.cases.charges.state` (string)
    The state where the person was charged
    Example: KY

  - `results.cases.charges.sentences` (array)

  - `results.cases.charges.sentences.release_type` (string)
    Type of release, if reported.

  - `results.cases.charges.sentences.details` (string)
    Description of the sentence, if any
    Example: fine, 1D

  - `results.cases.charges.dispositions` (array)

  - `results.cases.charges.dispositions.disposition` (string)
    A description of the disposition, as provided by the court, if any.
    Example: GLT

  - `results.cases.charges.dispositions.disposition_type` (string)
    the type of disposition
    Enum: "Conviction", "Dismissed", "Invalid", "Merged", "Pending", "Transferred", "Warrant", "Unclassified"

  - `results.cases.charges.checks` (array)
    Legal annotation check results for this charge.

  - `results.cases.charges.checks.action_type` (string)
    The action type determined by the legal rule evaluation:
- note: Informational annotation added to the item
- investigate: The item may require further review before inclusion
- remove: The item should not be reported based on legal restrictions
- modified: The item was modified (e.g., certain attributes were removed)
    Enum: "note", "investigate", "remove", "modified"

  - `results.cases.charges.checks.rule_id` (string)
    Identifier of the legal rule that triggered this check result.
    Example: CA-7yr-felony

  - `results.cases.charges.checks.rule_type` (string)
    The type of rule that was applied:
- legal: A rule based on statutory or regulatory requirements
- policy: A rule based on company policy
    Enum: "legal", "policy"

  - `results.cases.charges.checks.domain` (string)
    The filter domain in which this rule was applied.
    Example: employment

  - `results.cases.charges.checks.description` (string)
    Human-readable description of what the legal rule evaluated.
    Example: Felony convictions older than 7 years cannot be reported in California

  - `results.cases.charges.checks.run_at` (string)
    The timestamp when this check was evaluated.
    Example: 2024-01-15T10:30:00.000Z

  - `results.cases.checks` (array)
    Legal annotation check results for this case.

  - `results.checks` (array)
    Legal annotation check results for this record.

  - `excluded_records` (array)
    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.

  - `excluded_records.record_id` (string)
    An identifier for this record within the check result.
The same underlying record may share an ID across different checks. It is not a
permanent identifier: if the source data for a record changes, a later search may
return that record with a different ID.
    Example: record-7480fc7edac1a09867849999f2a2f6eec3cc37150f4ba65cbd1f46a4a1a5c15e

  - `excluded_records.source` (object)
    Reduced to jurisdiction fields only (category, state, county).

  - `excluded_records.source.county` (string)
    The name of the county (if any) where the record came from.
    Example: Franklin

  - `excluded_records.offense_classifications` (array)
    Classification of each charge on the excluded record, at the same category/subcategory/
subsubcategory granularity as a full record's charges. One entry per charge across all of
the record's cases.

  - `check_type` (string)
    The type of regulated check. Currently only instant_criminal_regulated is supported.
    Enum: "instant_criminal_regulated"

  - `reference_id` (string)
    A reference identifier for linking related records. Limited to 64 alphanumeric characters, underscores, and hyphens.
    Example: ref-123

  - `run_notes` (array)
    An unstructured array of human-readable notes about this particular check.
May contain notes about how input was parsed or other information about results.

  - `results_found` (boolean)
    Present only when `include[]=results_found` is requested; omitted otherwise.
When present, the `results` array is omitted.

  - `rulesets_applied` (array)
    Present only when `include[]=rulesets_applied` is requested; omitted otherwise.

  - `rulesets_applied.name` (string, required)

  - `rulesets_applied.description` (any)

  - `rulesets_applied.enabled` (boolean, required)

  - `rulesets_applied.default` (boolean, required)

  - `rulesets_applied.shared` (boolean, required)

  - `rulesets_applied.rules` (object, required)
    Rules engine definition used to filter results.

  - `rulesets_applied.account` (any)
    Account that owns the ruleset. Null when not applicable.

  - `rulesets_applied.account.company_name` (string, required)

  - `rulesets_applied.account.uri_name` (string, required)

  - `review` (any)
    Present only when `include[]=review` is requested; omitted otherwise.
Null when no accept/decline/dispute decision exists for this check.

  - `review.status` (string, required)
    Enum: "accepted", "declined", "disputed"

  - `review.adverse_action_id` (any)
    Associated adverse action record when status is `declined` or `disputed`; otherwise null.

  - `adverse_action_enabled` (boolean)
    Present only when `include[]=review` is requested; omitted otherwise.
Indicates whether adverse-action workflow is enabled for this product.

## Response 400:

  - `400` (unknown)
    Error response

## Response 400 fields (application/json):

  - `code` (string, required)
    A machine-readable error code.
    Example: invalid_request

  - `title` (string, required)
    A human-readable error title.
    Example: Invalid Request

  - `source` (object)
    An object containing references to the source of the error.

  - `source.pointer` (string)
    A JSON Pointer [RFC6901] to the associated entity in the request document.
    Example: /data/attributes/first_name

## Response 401:

  - `401` (unknown)
    Error response

## Response 401 fields (application/json):

  - `code` (string, required)
    A machine-readable error code.
    Example: invalid_request

  - `title` (string, required)
    A human-readable error title.
    Example: Invalid Request

  - `source` (object)
    An object containing references to the source of the error.

  - `source.pointer` (string)
    A JSON Pointer [RFC6901] to the associated entity in the request document.
    Example: /data/attributes/first_name

## Response 500:

  - `500` (unknown)
    Error response

## Response 500 fields (application/json):

  - `code` (string, required)
    A machine-readable error code.
    Example: invalid_request

  - `title` (string, required)
    A human-readable error title.
    Example: Invalid Request

  - `source` (object)
    An object containing references to the source of the error.

  - `source.pointer` (string)
    A JSON Pointer [RFC6901] to the associated entity in the request document.
    Example: /data/attributes/first_name

