Skip to main content

Search Types

Download this guide

The SNH AI 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