# Get check

Get a single check with a given id

Endpoint: GET /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.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.cases` (array)
    Only fields that have a value are returned.  Most cases will have only a subset of these fields.

  - `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)
    Only fields that have a value are returned.  Most charges will have only a subset of these fields.

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

  - `check_type` (string)
    Enum: "instant_criminal", "sex_offender_registry"

  - `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.
Not intended to be parsed by computer, as these notes are not guaranteed to be in any given format.
    Example: ["changed last_name from 'Smith Jr' to 'Smith'"]

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