Skip to main content

CriminalCheckDto Schema

The CriminalCheckDto configures criminal background check requirements and compliance features. This object is required when requesting CRIMINAL search type.

Required Fields

Optional Fields

Complete Example

{
  "jurisdictions": ["federal", "state", "county"],
  "criminalRecords": [
    {
      "criminalRecordId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "jurisdictionSearched": "CALIFORNIA STATEWIDE",
      "searchDate": "2024-01-15",
      "subjectName": "John Michael Smith",
      "subjectDob": "1990-05-15",
      "subjectSsn": "123-45-6789",
      "caseNumber": "CR-2020-001234",
      "caseStatus": "CLOSED",
      "courtName": "Superior Court of California, County of Los Angeles",
      "jurisdiction": "CA",
      "fileDate": "2020-01-20",
      "offenses": [
        {
          "offenseType": "THEFT",
          "offenseDescription": "Theft of property under $500",
          "offenseDate": "2020-01-15",
          "offenseCount": 1,
          "disposition": "GUILTY",
          "dispositionDate": "2020-06-15",
          "sentence": "6 months probation",
          "fineAmount": 500.0,
          "isFelony": false,
          "isMisdemeanor": true,
          "dispositionOther": "Adjudication withheld"
        }
      ]
    }
  ],
  "complianceRequirements": ["DOT_REGULATED", "FINANCIAL_SERVICES"],
  "worksiteState": "CA",
  "positionLevel": "STANDARD",
  "securityClearanceRequired": false,
  "industrySector": "TECHNOLOGY"
}

Nested Schemas

CriminalRecordDto

OffenseDto

Validation Rules

  • Jurisdictions Required: At least one jurisdiction level must be specified
  • Conditional Requirement: CriminalCheckDto is required when searchTypes includes “CRIMINAL”
  • Date Format: All dates must be in YYYY-MM-DD format
  • Offense Count: Must be minimum 1
  • Fine Amount: Must be 0 or greater