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.
Currently Supported: Only EMPLOYMENT and EDUCATION search types are available.

​
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"
  }
}

​
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"
    }
  ]
}

​
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 stored accreditation data (DAPIP CSVs maintained in GCS verifications-api-dataset-2026) and the live College Scorecard API
    • Includes accreditation timeline, agency, and validity window
    • Primary/secondary schools and international institutions are exempt

​
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. Monitor Search Status - Use the search endpoints to track verification progress

​
Next Steps