Once E-Verify has been configured and Forms I-9 are completed by employees, E-Verify cases will be automatically created. As a reminder, E-Verify is configured at the employer level.

While case actions (for example, photo confirmations and unconfirmed data) are handled by administrators through the embedded experience, you can access E-Verify case data through the API to support integration, reporting, and workflow logic.

Available Endpoints

1. Retrieve all E-Verify cases for an employer
2. Retrieve detailed E-Verify case data
3. Retrieve E-Verify account settings

Retrieve all e-verify cases for an employer

To return all cases for a specific employer, call the /employers/{employerId}/everifyCases GET endpoint. This endpoint returns summary information only. To view or manage the case, the employer administrator must log into the embedded E-Verify experience configured using the /employers/{employerId}/admins/{adminId}/everifySettings/generateToken GET endpoint.

Sample cURL request

curl --location 'https://api.symmetry.com/i9/v1/employers/0197145/everifyCases' \
--header 'Authorization: Bearer ••••••'

Query Parameter

Sample Response

{
  "everifyCases": [
    {
      "id": "0196ab0756754",
      "submissionId": 72,
      "caseId": "2025123482085BU",
      "caseStatus": "closed_authorized"
    }
  ]
}

Response fields

Retrieve detailed E-verify case data

The /employers/{employerId}/everifyCases/{id} endpoint retrieves detailed information for a specific E-Verify case, including timestamps, raw response data, and audit logs.

While this endpoint gives insight into the case’s history and result, all case actions must be taken within the embedded E-Verify experience by the employer’s administrator.

Sample cURL request

curl --location 'https://api.symmetry.com/i9/v1/employers/0197ad3412345/everifyCases/36'\
--header 'Authorization: Bearer ••••••'

Query Parameter

Sample Response

{
  "id": "0196ab07",
  "submission": {
    "submissionId": 72,
    "employeeId": "0196ab05"
  },
  "everifyCase": {
    "caseId": "2025384082085BU",
    "caseCreatedAt": "2025-05-05T15:45:15.000-06:00",
    "caseResultAt": "2025-05-05T15:45:17.000-06:00",
    "receipt": false,
    "caseStatus": "closed_authorized",
    "everifyAccountId": 1,
    "rawResponse": {
      "caseStatus": "CLOSED",
      "caseStatusDisplay": "Closed",
      "caseEligibilityStatement": "EMPLOYMENT_AUTHORIZED"
    },
    "auditLogs": [
      {
        "name": "case_status_change",
        "details": {
          "status": "submitted"
        },
        "serverTimestamp": "2025-05-05T15:45:15-06:00"
      },
      {
        "name": "case_status_change",
        "details": {
          "status": "draft"
        },
        "serverTimestamp": "2025-05-05T15:45:15-06:00"
      },
      {
        "name": "case_status_change",
        "details": {
          "status": "closed_authorized"
        },
        "serverTimestamp": "2025-05-05T15:45:17-06:00"
      }
    ],
    "tncI9Correct": false,
    "visitEverify": false,
    "deleteable": false,
    "unconfirmedDataFields": []
  }
}

Response fields

Top-Level Response Fields

submission Object

everifyCase Object

rawResponse Object

auditLogs Array

Retrieve E-Verify Account Settings

Use this endpoint to retrieve the current E-Verify configuration for an employer. This is helpful for verifying whether E-Verify has been configured and for displaying the stored administrator and credential settings in a UI.

To retrieve the current E-Verify configuration for an employer, call the /employers/{employerId}/everifySettings GET endpoint. This endpoint is helpful for verifying whether E-Verify has been configured and for displaying the stored administrator and credential settings in a UI. To view or manage the case, the employer administrator must log into the embedded E-Verify experience configured using the /employers/{employerId}/admins/{adminId}/everifySettings/generateToken GET endpoint.

Sample cURL request

curl --location 'https://api.symmetry.com/i9/v1/employers/0197145/everifySe' \
--header 'Authorization: Bearer ••••••'

Query Parameter

Sample Response

{
  "everifySettings": {
    "companyId": "123456",
    "programAdministratorEmail": "[email protected]",
    "programAdministratorFirstName": "John",
    "programAdministratorId": "789012",
    "programAdministratorLastName": "Doe",
    "programAdministratorPhone": "234-567-8901",
    "webServiceUsername": "everify_user"
  }
}

Elements