Skip to main content

​
Applicant Schema

The Applicant object contains all personal information about the individual being verified in a background check.

​
Required Fields

​
Optional Fields

​
Complete Example

{
  "firstName": "John",
  "lastName": "Smith",
  "ssn": "123-45-6789",
  "birthday": "1990-05-15",
  "phone": "+1-555-123-4567",
  "email": "[email protected]",
  "signedReleaseFileUrl": "https://example.com/signed-release.pdf",
  "addresses": [
    {
      "addressType": "home",
      "addressLine1": "456 Oak Avenue",
      "addressLine2": null,
      "addressCity": "Los Angeles",
      "addressState": "CA",
      "addressZipCode": "90210",
      "addressCountry": "US",
      "startDate": "2021-01-01",
      "endDate": null
    },
    {
      "addressType": "home",
      "addressLine1": "123 Main Street",
      "addressLine2": "Apt 4B",
      "addressCity": "New York",
      "addressState": "NY",
      "addressZipCode": "10001",
      "addressCountry": "US",
      "startDate": "2020-01-01",
      "endDate": "2021-01-01"
    }
  ],
  "applicantAlias": [
    {
      "firstName": "Jonathan",
      "lastName": "Smith",
      "middleName": "Michael",
      "suffix": "Jr."
    }
  ]
}

​
Validation Rules

  • SSN Format: Must follow XXX-XX-XXXX pattern
  • Email Format: Must be a valid email address
  • Date Format: All dates must be in YYYY-MM-DD format
  • Address Requirement: Exactly one address must be current (endDate: null)
  • URL Format: signedReleaseFileUrl must be a valid URL (HTTPS) or GCS URI (gs://)