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": 23,
    "documentName": "Form I-9",
    "documentFileName": "Form I-9.pdf",
    "verificationDocuments": [
      {
        "listKey": "A",
        "listIndex": 0,
        "documentationKey": "us_passport",
        "documentTitle": "U.S. Passport",
        "documentNumber": "123456789",
        "issuingAuthority": "U.S. Department of State",
        "expirationDate": "10/01/2025",
        "receipt": false,
        "fileFrontContentType": "image/jpeg",
        "fileFrontFilename": "U.S. Passport.jpeg"
      }
    ],
    "countersigned": true,
    "countersignable": true,
    "status": "accepted",
    "statusChangedBy": "AuthRep test (Authorized Representative)",
    "statusChangedAt": "2025-07-30T15:12:31Z",
    "submittedAt": "2025-07-30T15:03:48Z",
    "auditLogs": [
      {
        "eventName": "employee_submission_created",
        "details": {},
        "request": {
          "url": "https://symmetry-demo.workbright.com/i9_submission",
          "referrer": "https://symmetry-demo.workbright.com/forms/i9/submission/new",
          "remoteIp": "2600:4040:2970:6400:cd33:eda6:5512:cdad",
          "userAgent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/138.0.0.0 Safari/537.36",
          "serverName": "symmetry-demo.workbright.com"
        },
        "actorId": 74,
        "actorType": "EMPLOYEE",
        "serverTimestamp": "2025-07-30T11:03:48-04:00"
      },
      {
        "eventName": "employee_submit_location",
        "details": {
          "action": "event",
          "controller": "i9/remote_countersign"
        },
        "request": {
          "url": "https://symmetry-demo.workbright.com/rc/81ee14bd-fa84-44e0-98b0-9273897c77d3/event",
          "referrer": "https://symmetry-demo.workbright.com/i9_remote_countersign",
          "remoteIp": "2600:4040:2970:6400:cd33:eda6:5512:cdad",
          "userAgent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/138.0.0.0 Safari/537.36",
          "serverName": "symmetry-demo.workbright.com"
        },
        "serverTimestamp": "2025-07-30T11:11:21-04:00"
      },
      {
        "eventName": "employee_submit_auth_rep_phone",
        "details": {
          "action": "event",
          "controller": "i9/remote_countersign"
        },
        "request": {
          "url": "https://symmetry-demo.workbright.com/rc/81ee14bd-fa84-44e0-98b0-9273897c77d3/event",
          "referrer": "https://symmetry-demo.workbright.com/i9_remote_countersign",
          "remoteIp": "2600:4040:2970:6400:cd33:eda6:5512:cdad",
          "userAgent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/138.0.0.0 Safari/537.36",
          "serverName": "symmetry-demo.workbright.com"
        },
        "serverTimestamp": "2025-07-30T11:11:27-04:00"
      },
      {
        "eventName": "authorized_representative_submit_location",
        "details": {
          "action": "event",
          "controller": "i9/remote_countersign"
        },
        "request": {
          "url": "https://symmetry-demo.workbright.com/rc/81ee14bd-fa84-44e0-98b0-9273897c77d3/event",
          "referrer": "https://symmetry-demo.workbright.com/rc/81ee14bd-fa84-44e0-98b0-9273897c77d3",
          "remoteIp": "2600:4040:2970:6400:d476:1e72:8872:948",
          "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-demo.workbright.com"
        },
        "serverTimestamp": "2025-07-30T09:11:37-06:00"
      },
      {
        "eventName": "authorized_representative_qr_scan",
        "details": {
          "action": "event",
          "controller": "i9/remote_countersign"
        },
        "request": {
          "url": "https://symmetry-demo.workbright.com/rc/81ee14bd-fa84-44e0-98b0-9273897c77d3/event",
          "referrer": "https://symmetry-demo.workbright.com/rc/81ee14bd-fa84-44e0-98b0-9273897c77d3",
          "remoteIp": "2600:4040:2970:6400:d476:1e72:8872:948",
          "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-demo.workbright.com"
        },
        "serverTimestamp": "2025-07-30T09:12:01-06:00"
      },
      {
        "eventName": "authorized_representative_auth_rep_certify_identity",
        "details": {
          "action": "event",
          "controller": "i9/remote_countersign"
        },
        "request": {
          "url": "https://symmetry-demo.workbright.com/rc/81ee14bd-fa84-44e0-98b0-9273897c77d3/event",
          "referrer": "https://symmetry-demo.workbright.com/rc/81ee14bd-fa84-44e0-98b0-9273897c77d3",
          "remoteIp": "2600:4040:2970:6400:d476:1e72:8872:948",
          "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-demo.workbright.com"
        },
        "serverTimestamp": "2025-07-30T09:12:20-06:00"
      },
      {
        "eventName": "authorized_representative_submit_document_review",
        "details": {
          "action": "event",
          "controller": "i9/remote_countersign"
        },
        "request": {
          "url": "https://symmetry-demo.workbright.com/rc/81ee14bd-fa84-44e0-98b0-9273897c77d3/event",
          "referrer": "https://symmetry-demo.workbright.com/rc/81ee14bd-fa84-44e0-98b0-9273897c77d3",
          "remoteIp": "2600:4040:2970:6400:d476:1e72:8872:948",
          "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-demo.workbright.com"
        },
        "serverTimestamp": "2025-07-30T09:12:27-06:00"
      },
      {
        "eventName": "authorized_representative_submit_countersign",
        "details": {
          "action": "event",
          "controller": "i9/remote_countersign"
        },
        "request": {
          "url": "https://symmetry-demo.workbright.com/rc/81ee14bd-fa84-44e0-98b0-9273897c77d3/event",
          "referrer": "https://symmetry-demo.workbright.com/rc/81ee14bd-fa84-44e0-98b0-9273897c77d3",
          "remoteIp": "2600:4040:2970:6400:d476:1e72:8872:948",
          "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-demo.workbright.com"
        },
        "serverTimestamp": "2025-07-30T09:12:32-06:00"
      }
    ],
    "authRepRejected": false,
    "isCurrentSubmissionOfAssignment": true,
    "fields": {
      "firstName": "Laura",
      "lastName": "TEST",
      "street": "14350 N 87th St",
      "apt": "Ste 250",
      "city": "Scottsdale",
      "state": "AZ",
      "zip": "85260-2662",
      "ssn": "456-01-2785",
      "email": "[email protected]",
      "phone": "480-223-4567",
      "birthdate": "1975-03-15",
      "otherNames": "N/A",
      "citizenshipDesignation": "citizen",
      "employeeSignDate": "2025-07-30",
      "employeeStartDate": "2025-06-01",
      "employerCertifyDate": "2025-07-30",
      "employerTitle": "Authorized Representative",
      "employerFirstName": "AuthRep",
      "employerLastName": "test",
      "businessName": "Symmetry Software",
      "businessStreet": "14350 N 87th St",
      "businessCity": "Scottsdale",
      "businessState": "AZ",
      "businessZip": "85260",
      "lateReason": "OTHER",
      "lateReasonOther": "Remote Authorized Representative delay",
      "usedAltProcedure": "false"
    },
    "isExpired": false,
    "isReverified": false,
    "reverifyExists": false,
    "reverifyInProgress": false,
    "documentVerificationResult": "failed",
    "zipFile": "UEsDBBQACAgIAKF5inRVsrfUJmmtP"
  }
}

Response Elements

Submission object

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

ElementDescription
idInteger. Unique ID of the I-9 submission
auditLogsArray , where each object represents a recorded event or action related to the I-9 submission process
authRepRejectedBoolean. Indicates whether the authorized representative rejected the submission.
countersignedBoolean. Indicates Section 2 has been countersigned
countersignableBoolean. Indicates the form is eligible for countersignature
documentationExpirationDateString. Expiration of the next eligible document requiring update.
documentVerificationResolutionObject. Status of document verification. See fields below.
documentVerificationResultString. Status of document verification (approved, completed, declined, or failed).
documentNameString. Name of the submitted document. Will always return Form I-9
documentFileNameString.
fieldsObject. Contains key details about the Form I-9 submission.
isCurrentSubmissionOfAssignmentBoolean. Indicates if this is the most recent submission for the employee.
isExpiredBoolean. Indicates if the Form I-9 has expired.
isReverifiedBoolean. Indicates if this submission is part of a reverification.
rejectionReasonString. Reason provided, if the submission was rejected.
rejectionAdditionalDetailsString.
reverificationRehireArray. Contains data related to an employee's reverification or rehire.
reverifyExistsBoolean. Indicates the employee has been reverified.
reverifyInProgressBoolean. Indicates the remote verification for this submission been started.
statusEnum. Current status of the submission (pending, accepted, rejected)
statusChangedByString. Name of individual who accepted or rejected the form
statusChangedAtString. Timestamp of when submission was accepted or rejected
submittedAtString. Timestamp of when the submission was received
verificationDocumentsArray, where each object represents a document used for Form I-9 verification
zipFileString. A 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)

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

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 Verification Resolution

The document verification resolution object (documentVerificationResolution) contains a list of events for I-9 document verification acted on by the administrator.

Field NameDescription
actorIdInternal ID for audit purposes
actorNameName of the actor taking action on the document verification
actorTypeType of actor performing the event (for example, admin)
resolvedAtTimestamp of when the resolution action occurred

Reverification Rehire

The reverificationRehire array captures details related to an employee’s reverification or rehire event within the I-9 process.

Field NameDescription
submittedAtTimestamp when the reverification or rehire submission was completed by the authorized representative or employer.
dateDate the reverification or rehire action was taken
rehireDateEmployee's new hire date
newLastNameUpdated last name of the employee, if changed
newFirstNameUpdated first name of the employee, if changed
newMiddleInitialUpdated middle initial of the employee, if changed
reverifyDocumentTitleTitle of the document provided for reverification
reverifyDocumentNumberIdentification number on the reverification document
reverifyExpirationDateExpiration date of the reverification document (format: YYYY-MM-DD)
reverifyUsedAltProcedureIndicates whether the USCIS alternative procedure was used for reverification
employerOrAuthrepNameName of the employer or authorized representative who submitted the reverification
additionalInfoOptional free-form notes or comments included with the submission

Fields

The fields object contains key details on the Form I-9 submission.

Field NameDescription
firstNameEmployee's legal first name
middleInitialEmployee's legal middle initial
lastNameEmployee's legal last name
streetStreet address of the employee's residence (streetAddress1)
aptApartment number or unit (streetAddress2)
cityCity of the employee's residence
stateState abbreviation
zipZIP code of the employee's residence (zipCode)
ssnEmployee’s Social Security Number (socialSecurityNumber)
emailEmployee's email address (emailAddress)
phoneEmployee's phone number (telephoneNumber)
birthdateEmployee's date of birth (dateOfBirth)
otherNamesAny other names used by the employee. Will return N/A if none.
citizenshipDesignationCitizenship status: citizen, noncitizen_national, permanent_resident, or alien.
employeeSignDateDate the employee signed Section 1 of the I-9 (format: YYYY-MM-DD)
employeeStartDateEmployee's start date
employerCertifyDateDate the employer completed and signed Section 2
employerTitleTitle of the employer representative who countersigned the Form I-9
employerFirstNameFirst name of the employer representative who countersigned the Form I-9
employerLastNameLast name of the employer representative who countersigned the Form I-9
businessNameName of the service provider
businessStreetEmployer's street address (streetAddress1)
businessCityCity of the employer's business
businessStateState abbreviation of the employer's business
businessZipZIP code of the employer's business (zipCode)
lateReasonReason for certification occurring more than 3 business days after the employee's start date
lateReasonOtherExplanation provided if "Other" is selected as lateReason.
usedAltProcedureIndicates that the employer used alternative procedure to verify the employee's documents

Jump to top