# Get regulated check

Get a single regulated check with a given id.

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

## Path parameters:

  - `check_id` (string, required)
    The uuid identifying the check
    Example: "2b8313e8-4efd-45a1-b578-952b8313e890"

## Query parameters:

  - `include` (array)
    Include related resources in the response

## Response 200 fields (application/json):

  - `id` (string)
    A universally unique identifier (UUID) in standard format.

  - `created_at` (string)
    An ISO 8601 formatted date-time string.

  - `completed_at` (string)
    An ISO 8601 formatted date-time string.

  - `results` (array)
    When there are no results found, this will be an empty array.

  - `results.record_id` (string)
    A stable identifier for this record, derived from the record content.
Format: record-{sha256_hash}.
This ID is globally unique across all checks and can be referenced
in adverse action requests to identify disqualifying records.
    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.person` (object)

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

  - `results.person.inferred_dob` (string)
    Some records which do not already have a full DOB may have an inferred full DOB that was found by other means.
For example a record may have no dob, or only a partial dob, but we were able to inferred a full dob using other similar records.

  - `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.
    Example: ["Johnny Smith"]

  - `results.person.dob_aliases` (array)
    Other dates of birth that this person may have used.
    Example: ["19940321"]

  - `results.person.addresses` (array)
    Addresses that are recorded for this person on this record.

  - `results.person.addresses.street` (string, required)
    The street address, including house/building number and street name. Apartment/unit numbers may be included but are not used for matching.
    Example: "123 Main St"

  - `results.person.addresses.city` (string, required)
    The name of the city or municipality.
    Example: "Frankfort"

  - `results.person.addresses.state` (string, required)
    The two-letter US state code where the address is located.

  - `results.person.addresses.zip_code` (string, required)
    The US postal ZIP code for the address.

  - `results.person.addresses.country` (string)
    The two-letter country code, typically "US" for United States addresses.

  - `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.state` (string)
    A two-letter US state code.

  - `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.file_date` (string)
    The date the case was filed as reported by the court.  Not present for records which are not from a court.

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

  - `results.cases.arrest_date` (string)
    The date the person was arrested.

  - `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.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.offense_date` (string)
    The date the offense was committed, as reported on the record.

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

  - `results.cases.charges.record_date` (string)
    Date of the record.
This is not part of the record itself.
It is a field calculated by Checkr Trust.
It is the field used to determine if the charge is within the lookback period.
Although there are many other situations, often a convicted charge has a
record_date which is the disposition_date, and a non-conviction charge
has a record_date which is the filing date.

  - `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.conviction_date` (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.

  - `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_date` (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.

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

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

  - `status` (string)
    The current status of the regulated check.
    Example: "completed"

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

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

## 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 404 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 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"