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
Element | Type | Description |
---|---|---|
employerId | string | Required. The unique identifier of the employer. |
employeeId | string | Required. The unique identifier of the employee who completed the I-9. |
submissionId | string | Required. 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.
Element | Description |
---|---|
id | Unique ID of the I-9 submission |
employeeId | Unique identifier for the employee associated with this submission |
documentName | Name of the submitted document. Will always return Form I-9 |
status | Current status of the submission (pending , accepted , rejected ) |
submittedAt | Timestamp of when the submission was received |
statusChangedBy | Name of individual who accepted or rejected the form |
statusChangedAt | Timestamp of when submission was accepted or rejected |
countersigned | Indicates Section 2 has been countersigned |
countersignable | Indicates the form is eligible for countersignature |
verificationDocuments | Array of objects, where each object represents a document used for Form I-9 verification |
auditLogs | Array of objects, where each object represents a recorded event or action related to the I-9 submission process |
pdf | 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.
Element | Description |
---|---|
listKey | Indicates which document list (A , B , or C ) the provided document belongs to, according to Form I-9 requirements |
documentationKey | Internal key identifying the document type. See full list below. |
documentTitle | Human-readable name of the document, displayed in the user interface and included in the final Form I-9. See full list below . |
documentNumber | The unique identifying number found on the document (e.g. passport number, license number). This is printed on the finalized Form I-9. |
issuingAuthority | The agency or institution that issued the document. This is printed on the finalized Form I-9. |
expirationDate | Date the document expires |
receipt | Indicates 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.
Element | Description |
---|---|
eventName | Name of the event. See full list here. |
eventTitle | Deprecated |
details | Information related to the specific event |
request | Metadata about the HTTP request that triggered the audit event |
userType | User type who triggered the event (EMPLOYEE , ADMIN ) |
serverTimestamp | Timestamp 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.
documentationKey | documentTitle |
---|---|
us_passport | U.S. Passport |
us_passport_card | U.S. Passport Card |
permanent_resident_card | Permanent Resident Card |
alien_registration_receipt_card | Alien Registration Receipt Card (Form I-551) |
foreign_passport | Foreign passport containing temporary I-551 stamp |
foreign_passport_mriv | Foreign passport containing a temporary I-551 printed notation on a machine-readable immigrant visa |
employment_auth_doc | Employment Authorization Document w/ photograph (Form I-776) |
foreign_passport_with_i94 | Foreign 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_i94 | Passport from Federated States of Micronesia (FSM) with Form I-94 |
rmi_passport_with_i94 | Passport from Republic of Marshall Islands (RMI) with Form I-94 |
i551_stamp | A supporting document required for certain other types of documentation |
mriv | A supporting document required for certain other types of documentation |
form_i94 | A supporting document required for certain other types of documentation |
i94_supporting_doc | A supporting document required for certain other types of documentation |
drivers_license | Driver's license issued by a state or territory |
state_id_card | ID card issued by a state or territory |
id_card | ID card issued by federal, state or local government agencies or entities |
school_id_card | School ID card |
voter_registration_card | Voter registration card |
military_card | U.S. military card |
military_draft_record | U.S. military draft record |
military_dependent_id_card | Military dependent's ID card |
uscgmm_card | US Coast Guard Merchant Mariner Card |
native_american_tribal_document | Native American tribal document |
canadian_drivers_license | Driver's license issued by a Canadian government authority |
under18_school_report_card | School record or report card (under age 18 only) |
under18_doctor_record | Clinic, doctor or hospital record (under age 18 only) |
under18_daycare_record | Day-care or nursery school record (under age 18 only) |
under18_none | Minor under age 18 without identification document |
special_placement | Special placement |
ssn_card | Social Security Card |
cert_birth_abroad | Certification of Birth Abroad (Form FS-545) |
cert_report_birth | Certification of Report of Birth (Form DS-1350) |
cert_consular_report_birth | Consular Report of Birth Abroad (Form FS-240) |
us_birth_certificate | U.S. birth certificate (original or certified copy) |
native_american_tribal_document2 | Native American tribal document |
us_citizen_id_card | U.S. Citizen ID card (Form I-197) |
id_card_resident_citizen | ID Card for Use of Resident Citizen in the U.S. (Form I-179) |
employment_auth_by_dhs | Employment authorization issued by the DHS |
Updated 4 days ago