Skip to main content
The Theary Background Check API supports multiple types of verification searches. Each search type has specific requirements and returns different types of verification data.

​
Available Search Types

​
Employment Verification (EMPLOYMENT)

Verifies employment history, job titles, dates of employment, and salary information. Required Fields:
  • searchTitle - Job title or position being verified
  • entityName - Employer name
  • entityLocation - Employer location
  • employmentDates - Start and end dates
Example: 
{
  "searchTypes": [
    {
      "searchType": "EMPLOYMENT",
      "searchTitle": "Senior Software Engineer"
    }
  ],
  "entityName": "Apple Inc.",
  "jobTitle": "Senior Software Engineer",
  "employmentDates": {
    "startDate": "2020-01-15",
    "endDate": "2023-06-30"
  }
}

​
Education Verification (EDUCATION)

Verifies educational credentials, degrees, graduation dates, and academic achievements. Required Fields:
  • searchTitle - Degree or certification being verified
  • entityName - Institution name
  • entityLocation - Institution location
Example: 
{
  "searchTypes": [
    {
      "searchType": "EDUCATION",
      "searchTitle": "Bachelor of Science in Computer Science"
    }
  ],
  "entityName": "Stanford University",
  "entityLocation": "Stanford, CA",
  "employmentDates": {
    "startDate": "2016-09-01",
    "endDate": "2020-06-15"
  }
}

​
Criminal Compliance Check (CRIMINAL)

Performs comprehensive criminal compliance checks across specified jurisdictions. Required Fields:
  • searchTitle - Type of criminal check
  • criminalCheck - Criminal check configuration (required)
Example: 
{
  "searchTypes": [
    {
      "searchType": "CRIMINAL",
      "searchTitle": "Criminal Background Check"
    }
  ],
  "criminalCheck": {
    "jurisdictions": ["federal", "state", "county"],
    "worksiteState": "CA",
    "positionLevel": "STANDARD",
    "securityClearanceRequired": false,
    "industrySector": "TECHNOLOGY"
  }
}

​
Multiple Search Types

You can request multiple verification types in a single order: 
{
  "searchTypes": [
    {
      "searchType": "EMPLOYMENT",
      "searchTitle": "Software Engineer"
    },
    {
      "searchType": "EDUCATION",
      "searchTitle": "Bachelor of Computer Science"
    },
    {
      "searchType": "CRIMINAL",
      "searchTitle": "Criminal Background Check"
    }
  ],
  "criminalCheck": {
    "jurisdictions": ["federal", "state"]
  }
}

​
Criminal Check Configuration

When requesting CRIMINAL search type, you must include a criminalCheck object. See CriminalCheckDto for the complete schema, validation rules, and examples. Key fields:
  • jurisdictions (required)
  • complianceRequirements
  • worksiteState
  • positionLevel
  • securityClearanceRequired
  • industrySector

​
Search Results

Each search type returns different result structures:

​
Employment Results

  • Employment dates verification
  • Job title confirmation
  • Salary verification (if available)
  • Eligibility for rehire status

​
Education Results

  • Degree verification
  • Graduation date confirmation
  • GPA verification (if available)
  • Academic honors or distinctions
  • Accreditation status (automatically included for post-secondary institutions)
    • Uses graduation date or attendance dates as reference
    • Checks both CSV datasets and live College Scorecard API
    • Includes accreditation timeline, agency, and validity window
    • Primary/secondary schools and international institutions are exempt

​
Criminal Results

  • Criminal record details
  • Offense information
  • Disposition status
  • Compliance assessment

​
Best Practices

  1. Choose Appropriate Search Types - Only request the verification types you actually need
  2. Provide Complete Information - More detailed input leads to better verification results
  3. Handle Criminal Compliance - Always provide proper criminalCheck configuration for CRIMINAL searches
  4. Monitor Search Status - Use the search endpoints to track verification progress

​
Next Steps