Receive Completed I-9 Data

Once an employee’s Form I-9 is completed (both Section 1 and Section 2 are complete), Symmetry returns all completed Form I-9 metadata and PDF data as JSON to the postback URL configured for the relevant employer. Additionally, completed Form I-9 data can be retrieved at any time using the I-9 submission endpoint for the appropriate submission. Completed I-9 data includes a full audit log of metadata associated with the I-9 as well as a Base64 encoded PDF for storage in your platform.

Retrieve I-9 Submission

To retrieve a completed I-9, make a GET request to the /employers/{employerId}/employees/{employeeId}/submissions/{submissionId} endpoint.

Sample Request

curl --location 'https://api.symmetry.com/i9/v1/employers/01971d41-b29d-75cf-a308-15ca267af31c/employees/01972151-86d6-7447-aa2a-123456/submissions/118' \
--header 'Authorization: Bearer ••••••'

Path Parameters

ElementTypeDescription
employerIdstringRequired. The unique identifier of the employer.
employeeIdstringRequired. The unique identifier of the employee who completed the I-9.
submissionIdstringRequired. The unique identifier of the employee's I-9 submission. Retrieved from the /employers/{employerId}/employees/{employeeId}/submissions endpoint.

Response

A successful request returns a JSON response with I-9 details, including document verification results, audit log, and the completed PDF encoded in Base64.

{
  "submission": {
    "id": 118,
    "employeeId": "0197175b-752c-7780-837d-12345",
    "documentName": "Form I-9",
    "verificationDocuments": [
      {
        "listKey": "A",
        "documentationKey": "us_passport",
        "documentTitle": "U.S. Passport",
        "documentNumber": "123456789",
        "issuingAuthority": "U.S. Department of State",
        "expirationDate": "06/02/2025",
        "receipt": false
      }
    ],
    "countersigned": true,
    "countersignable": true,
    "status": "accepted",
    "statusChangedBy": "Laura Tester (Authorized Representative)",
    "statusChangedAt": "2025-05-28T14:54:07Z",
    "submittedAt": "2025-05-28T14:49:09Z",
    "auditLogs": [
      {
        "eventName": "employee_submission_created",
        "eventTitle": "null",
        "details": {},
        "request": {
          "url": "https://symmetry.workbright.com/i9_submission",
          "referrer": "https://symmetry.workbright.com/forms/i9/submission/new",
          "remoteIp": "2600:4040:2975:dd00:7427:1036:8e9:12fc",
          "userAgent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/136.0.0.0 Safari/537.36",
          "serverName": "symmetry.workbright.com"
        },
        "userType": "EMPLOYEE",
        "serverTimestamp": "2025-05-28T10:49:10-04:00"
      },
      {
        "eventName": "employee_submit_location",
        "eventTitle": "null",
        "details": {
          "action": "event",
          "controller": "i9/remote_countersign"
        },
        "request": {
          "url": "https://symmetry.workbright.com/rc/3f8f816a-dc4d-4f53-9ae2-7d386d2d96a8/event",
          "referrer": "https://symmetry.workbright.com/i9_remote_countersign",
          "remoteIp": "2600:4040:2975:dd00:7427:123:123:12fc",
          "userAgent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/136.0.0.0 Safari/537.36",
          "serverName": "symmetry.workbright.com"
        },
        "serverTimestamp": "2025-05-28T10:52:49-04:00"
      },
      {
        "eventName": "employee_submit_auth_rep_phone",
        "eventTitle": "null",
        "details": {
          "action": "event",
          "controller": "i9/remote_countersign"
        },
        "request": {
          "url": "https://symmetry.workbright.com/rc/3f8f816a-dc4d-4f53-9ae2-7d386d2d96a8/event",
          "referrer": "https://symmetry.workbright.com/i9_remote_countersign",
          "remoteIp": "2600:4040:2975:dd00:7427:1234:8e9:12fc",
          "userAgent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/136.0.0.0 Safari/537.36",
          "serverName": "symmetry.workbright.com"
        },
        "serverTimestamp": "2025-05-28T10:53:08-04:00"
      },
      {
        "eventName": "authorized_representative_submit_location",
        "eventTitle": "null",
        "details": {
          "action": "event",
          "controller": "i9/remote_countersign"
        },
        "request": {
          "url": "https://symmetry-sandbox.workbright.com/rc/3f8f816a-dc4d-4f53-9ae2-7d386d2d96a8/event",
          "referrer": "https://symmetry-sandbox.workbright.com/rc/3f8f816a-dc4d-4f53-9ae2-7d386d2d96a8",
          "remoteIp": "2600:4040:2975:dd00:edf7:d0b4:921a:aca9",
          "userAgent": "Mozilla/5.0 (iPhone; CPU iPhone OS 18_5 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/18.5 Mobile/15E148 Safari/604.1",
          "serverName": "symmetry-sandbox.workbright.com"
        },
        "serverTimestamp": "2025-05-28T08:53:49-06:00"
      },
      {
        "eventName": "authorized_representative_auth_rep_certify_identity",
        "eventTitle": "null",
        "details": {
          "action": "event",
          "controller": "i9/remote_countersign"
        },
        "request": {
          "url": "https://symmetry-sandbox.workbright.com/rc/3f8f816a-dc4d-4f53-9ae2-7d386d2d96a8/event",
          "referrer": "https://symmetry-sandbox.workbright.com/rc/3f8f816a-dc4d-4f53-9ae2-7d386d2d96a8",
          "remoteIp": "2600:4040:2975:dd00:edf7:d0b4:921a:aca9",
          "userAgent": "Mozilla/5.0 (iPhone; CPU iPhone OS 18_5 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/18.5 Mobile/15E148 Safari/604.1",
          "serverName": "symmetry-sandbox.workbright.com"
        },
        "serverTimestamp": "2025-05-28T08:53:56-06:00"
      },
      {
        "eventName": "authorized_representative_submit_document_review",
        "eventTitle": "null",
        "details": {
          "action": "event",
          "controller": "i9/remote_countersign"
        },
        "request": {
          "url": "https://symmetry-sandbox.workbright.com/rc/3f8f816a-dc4d-4f53-9ae2-7d386d2d96a8/event",
          "referrer": "https://symmetry-sandbox.workbright.com/rc/3f8f816a-dc4d-4f53-9ae2-7d386d2d96a8",
          "remoteIp": "2600:4040:2975:dd00:edf7:d0b4:921a:aca9",
          "userAgent": "Mozilla/5.0 (iPhone; CPU iPhone OS 18_5 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/18.5 Mobile/15E148 Safari/604.1",
          "serverName": "symmetry-sandbox.workbright.com"
        },
        "serverTimestamp": "2025-05-28T08:54:02-06:00"
      },
      {
        "eventName": "authorized_representative_submit_countersign",
        "eventTitle": "null",
        "details": {
          "action": "event",
          "controller": "i9/remote_countersign"
        },
        "request": {
          "url": "https://symmetry-sandbox.workbright.com/rc/3f8f816a-dc4d-4f53-9ae2-7d386d2d96a8/event",
          "referrer": "https://symmetry-sandbox.workbright.com/rc/3f8f816a-dc4d-4f53-9ae2-7d386d2d96a8",
          "remoteIp": "2600:4040:2975:dd00:edf7:d0b4:921a:aca9",
          "userAgent": "Mozilla/5.0 (iPhone; CPU iPhone OS 18_5 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/18.5 Mobile/15E148 Safari/604.1",
          "serverName": "symmetry-sandbox.workbright.com"
        },
        "serverTimestamp": "2025-05-28T08:54:07-06:00"
      }
    ],
    "pdf": "JVBERi0xLjc"
  }
}

Response Elements

Submission object

A successful response returns the submission object. Below are the fields within the submission.

ElementDescription
idUnique ID of the I-9 submission
employeeIdUnique identifier for the employee associated with this submission
documentNameName of the submitted document. Will always return Form I-9
statusCurrent status of the submission (pending, accepted, rejected)
submittedAtTimestamp of when the submission was received
statusChangedByName of individual who accepted or rejected the form
statusChangedAtTimestamp of when submission was accepted or rejected
countersignedIndicates Section 2 has been countersigned
countersignableIndicates the form is eligible for countersignature
verificationDocumentsArray of objects, where each object represents a document used for Form I-9 verification
auditLogsArray of objects, where each object represents a recorded event or action related to the I-9 submission process
pdfA base64-encoded representation of the signed PDF of the Form I-9. Can be decoded for file generation.

Verification Documents

The verification documents array contains information on the documentation submitted for review.

ElementDescription
listKeyIndicates which document list (A, B, or C) the provided document belongs to, according to Form I-9 requirements
documentationKeyInternal key identifying the document type. See full list below.
documentTitleHuman-readable name of the document, displayed in the user interface and included in the final Form I-9. See full list below .
documentNumberThe unique identifying number found on the document (e.g. passport number, license number). This is printed on the finalized Form I-9.
issuingAuthorityThe agency or institution that issued the document. This is printed on the finalized Form I-9.
expirationDateDate the document expires
receiptIndicates whether the employee presented a receipt in place of the document (true = yes, false = no)

Audit Logs

Each audit log object represents an action taken on the submission, tracked for compliance. An array is returned that contains an object for each action. Read more about audit logs here.

ElementDescription
eventNameName of the event. See full list here.
eventTitleDeprecated
detailsInformation related to the specific event
requestMetadata about the HTTP request that triggered the audit event
userTypeUser type who triggered the event (EMPLOYEEADMIN)
serverTimestampTimestamp of when the event occurred based on the time zone of the server. ISO 8601 format.

Document Types

Below is the full list of documentation (documentationKey and documentTitle) employees can use to complete their I-9.

documentationKeydocumentTitle
us_passportU.S. Passport
us_passport_cardU.S. Passport Card
permanent_resident_cardPermanent Resident Card
alien_registration_receipt_cardAlien Registration Receipt Card (Form I-551)
foreign_passportForeign passport containing temporary I-551 stamp
foreign_passport_mrivForeign passport containing a temporary I-551 printed notation on a machine-readable immigrant visa
employment_auth_docEmployment Authorization Document w/ photograph (Form I-776)
foreign_passport_with_i94Foreign passport and Form I-94/I-94A for a nonimmigrant alien authorized to work for a specific employer because of his or her status
fsm_passport_with_i94Passport from Federated States of Micronesia (FSM) with Form I-94
rmi_passport_with_i94Passport from Republic of Marshall Islands (RMI) with Form I-94
i551_stampA supporting document required for certain other types of documentation
mrivA supporting document required for certain other types of documentation
form_i94A supporting document required for certain other types of documentation
i94_supporting_docA supporting document required for certain other types of documentation
drivers_licenseDriver's license issued by a state or territory
state_id_cardID card issued by a state or territory
id_cardID card issued by federal, state or local government agencies or entities
school_id_cardSchool ID card
voter_registration_cardVoter registration card
military_cardU.S. military card
military_draft_recordU.S. military draft record
military_dependent_id_cardMilitary dependent's ID card
uscgmm_cardUS Coast Guard Merchant Mariner Card
native_american_tribal_documentNative American tribal document
canadian_drivers_licenseDriver's license issued by a Canadian government authority
under18_school_report_cardSchool record or report card (under age 18 only)
under18_doctor_recordClinic, doctor or hospital record (under age 18 only)
under18_daycare_recordDay-care or nursery school record (under age 18 only)
under18_noneMinor under age 18 without identification document
special_placementSpecial placement
ssn_cardSocial Security Card
cert_birth_abroadCertification of Birth Abroad (Form FS-545)
cert_report_birthCertification of Report of Birth (Form DS-1350)
cert_consular_report_birthConsular Report of Birth Abroad (Form FS-240)
us_birth_certificateU.S. birth certificate (original or certified copy)
native_american_tribal_document2Native American tribal document
us_citizen_id_cardU.S. Citizen ID card (Form I-197)
id_card_resident_citizenID Card for Use of Resident Citizen in the U.S. (Form I-179)
employment_auth_by_dhsEmployment authorization issued by the DHS

Jump to top