v1

latestOpenAPI 3.1.02026-07-241695611.0 MB

Criminal Checks

Create Criminal Check

Create a new criminal check.

post/criminal_checks

Request body

check_type'instant_criminal' | 'sex_offender_registry' required

The type of criminal check to run.

first_namestring required

The first name of the person

last_namestring required

The last name of the person

date_of_birthstring date required

The date of birth of the person. Cannot be in the future.

middle_namestring nullable

The middle name of the person

ssnstring required

The social security number of the person

phone_numberstring nullable

Phone number in E.164 format (US numbers start with +1).

primary_addressstring nullable

The primary address to search for criminal records

additional_addressesstring[] nullable

A list of additional addresses to search

reference_idstring nullable

An optional reference ID to associate with the request. Limited to alphanumeric characters and hyphens.

source_statesStateAbbreviation[] nullable

A list of states criminal records must originate from. When supplied, records are filtered to the specified states only. Records without a source state are always included.

Example request

{
  "first_name": "John",
  "last_name": "Smith",
  "date_of_birth": "1990-01-15",
  "middle_name": "Mary Louise",
  "ssn": "123-45-6789",
  "phone_number": "+14155552671",
  "primary_address": "123 Main St, Springfield, IL 62704",
  "additional_addresses": [
    "456 Test Blvd, Anytown, GA 44556",
    "456 Oak Ave, Chicago, IL 60601"
  ],
  "reference_id": "Check1234",
  "source_states": [
    "CA",
    "IL"
  ]
}

Response

Successful Response

idstring uuid required

The unique identifier of the criminal check.

created_atstring date-time required

The date and time when the criminal check was created.

updated_atstring date-time nullable

The date and time when the criminal check was last updated.

first_namestring required

The first name of the person.

last_namestring required

The last name of the person.

date_of_birthstring date required

The date of birth of the person.

ssnstring required

The social security number of the person, masked up to the final four digits

middle_namestring nullable

The middle name of the person.

phone_numberstring nullable

The phone number of the person in E.164 format.

emailstring nullable

The email address of the person.

check_type'instant_criminal' | 'sex_offender_registry' required

The type of criminal check to run.

reference_idstring nullable

The reference ID associated with this request.

Example response

{
  "id": "ed512e1b-6d66-4311-a9b9-9b2308d62005",
  "created_at": "2026-07-16T19:24:27.723473",
  "updated_at": "2026-07-16T19:24:27.723488",
  "first_name": "John",
  "last_name": "Smith",
  "date_of_birth": "1990-01-15",
  "ssn": "XXXXX1234",
  "middle_name": "Mary Louise",
  "phone_number": "+14155552671",
  "email": "john.doe@example.com",
  "primary_address": {
    "street": "913 Hendrix Gardens Suite 492",
    "city": "Jasonfurt",
    "zip": "19773"
  },
  "additional_addresses": [
    {
      "city": "Anytown",
      "state": "CA",
      "street": "456 Test Blvd",
      "zip": "12345"
    }
  ],
  "results": [
    {
      "person": {
        "first_name": "John",
        "middle_name": "W",
        "last_name": "Smith",
        "suffix": "Jr.",
        "date_of_birth": "1990-01-15",
        "inferred_date_of_birth": "1990-01-15",
        "height": "601",
        "weight": "180",
        "hair_color": "BRN",
        "eye_color": "HAZ",
        "skin_color": "wht",
        "race": "W",
        "ethnicity": "Hispanic-American",
        "physical_build": "BROAD",
        "physical_marks": "blue cross on outside left ankle",
        "name_aliases": [
          "Johnny Smith"
        ],
        "addresses": [
          {
            "city": "Anytown",
            "state": "CA",
            "street": "123 Main St",
            "zip": "12345"
          }
        ]
      },
      "source": {
        "name": "KY Franklin County Inmates",
        "county": "Franklin",
        "county_fips_code": "17031"
      },
      "cases": [
        {
          "case_number": "2025-99999",
          "file_date": "2025-01-01",
          "arresting_agency": "Franklin County Sheriff",
          "arrest_date": "2025-01-01",
          "court_name": "Franklin County Circuit Court",
          "court_county": "Franklin",
          "charges": [
            {
              "description": "SHOPLIFTING",
              "offense_date": "2025-01-01",
              "legal_code": "433.234",
              "subsubcategory": "SHOPLIFTING",
              "record_date": "2025-01-01",
              "city": "Indian Hills",
              "county": "Jefferson",
              "sentences": [
                {
                  "conviction_date": "2025-01-01",
                  "details": "fine, 1D"
                }
              ],
              "dispositions": [
                {
                  "disposition": "GLT",
                  "disposition_date": "2025-01-01"
                }
              ]
            }
          ]
        }
      ]
    }
  ],
  "reference_id": "Check1234"
}