An object that represents an Employee's form submission.
The following attributes are present for all form submissions:
Attributes | Type | Description |
---|---|---|
| Integer | Unique identifier representing the form submission. |
| Integer | The ID of the staff member who completed the submission. |
| String | The status of the form submission (pending, accepted, rejected). |
| String | The name of the form this submission corresponds with. |
| Array of Strings | A set of user-defined tags on this submission, applied by admins. |
| Array of Audit Logs | A list of countersigning events for I-9 Remote Verification submissions. Note: All forms have this category, only the I-9 uses it. See the for more information. |
| Integer | The ID of the form this submission corresponds with. |
| String (format: ) | Timestamp of when the submission was received. |
| Boolean | Did the auth rep reject this submission? |
| String | If status is 'rejected', and the reason is given, it is provided here. |
| String | Name of individual who accepted or rejected the form. |
| String (format: ) | Timestamp of when submission was accepted or rejected. |
| Boolean | Is this the most current submission for the assignment? |
| String | The name of the user who uploaded the submission. |
| Boolean | Is the submission ready to be countersigned? |
| Boolean | Is this submission countersigned? i.e. Section 2 of I-9. |
| String | Timestamp of when the staff member reviewed an uploaded submission. |
| Array of Strings | URLs to obtain all PDF and image files associated with this submission. |
| Array of Fields OR Object | Form-I9: Object with attributes, see below. Everything else: Array of field objects (custom and/or standard). |
| String | The status of the document verification (approved, completed, declined, or failed). |
| Array of Audit Logs | A list of events for I-9 document verification acted upon by the administrator. |
| String | 2-3 code representing the country associated with an EAD. |
| String | The specific classification or type of Employment Authorization Document (EAD) granted to an individual. |
The following attributes are only present for Form-I9 submissions (in addition to those listed above):
Attributes | Type | Description |
---|---|---|
fields | Object | Fields object below. |
documentation_set | Object | Documentation Set object below. |
is_expired | Boolean | Is this Form-I9 expired? |
missing_start_date | Boolean | Is this employee missing their start date? |
is_reverified | Boolean | Is this submission remote verified? |
reverify_exists | Boolean | Has this employee ever been reverified? |
reverify_in_progress | Boolean | Has a remote verification for this submission been started? |
documentation_expiration_date | String (format: YYYY-MM-DD ) | Expiration date for the next expiring eligible document that will need to be updated. |
preparer_translator | Object | Preparer translator object below, if applicable. |
reverification_rehire | Object | Reverification object below, if applicable. |
Fields of the Form-I9
Attributes | Type | Description |
---|---|---|
| String | Legal first name. |
| String | Legal middle initial. |
| String | Legal last name. |
| String | Street address. |
| String | Apartment. |
| String | City. |
| String | State abbreviation (e.g. CO). |
| String | Zip code. |
| String (format: | US-based social security number. |
| String | Email address. |
| String | Free format primary phone number. |
| String (format: | Birthdate. |
| String | Any other names used. "N/A" if none. |
| String | Citizenship ( |
| String (format: YYYY-MM-DD) OR "N/A" | Expiration date of employment authorization. |
| String (format: | Signature date. |
| String (format: | Employee start date; Present after certification. |
| String (format: | Employer certification date; Present after certification. |
| String | Title of countersigning employer; Present after certification. |
| String | First name of countersigning employer; Present after certification. |
| String | Last name of countersigning employer; Present after certification. |
| String | Business name; Present after certification. |
| String | Business street address; Present after certification. |
| String | Business city; Present after certification. |
| String | Business state abbreviation (e.g. CO); Present after certification. |
| String | Business zip code; Present after certification. |
| String | Only exists if the certification took place over three days after the start date; Present after certification if applicable. |
| String | Corresponding explanation if user selects "other" from the dropdown menu for late_reason; Present after certification if applicable. |
| Boolean | Did the employee use a USCIS Alternative Procedure to verify the I-9 documentation? Present after certification. |
Documentation Set object. Details the documentation provided by an employee in an I-9.
Attributes | Type | Description |
---|---|---|
| String (A, B, or C) | List the document is included in as part of official "List of Acceptable Documents" |
| String | Index of document in official "List of Acceptable Document" |
| String | Unique name of document for verification purposes- not displayed to user. |
| String | Document Number (e.g. Driver's License Number, Passport Number, etc.) |
| String | Document Title (e.g. U.S. Passport). |
| String | Issuing Authority (e.g. U.S. Department of State). |
| String (format: YYYY-MM-DD) OR "N/A" OR "D/S" | Expiration Date. |
| Boolean | Is this a receipt of the document instead of the document itself? |
| String | Path to document front image file. |
| String | Content type of document front image file. |
| String | Filename of document front image file. |
| String | Path to document back image file. |
| String | Content type of document back image file. |
| String | Filename of document back image file. |
Reverification Rehire object: Information about an employee's reverification.
Attributes | Type | Description |
---|---|---|
| String (format: ) | Timestamp of submission by auth rep or employer. |
|
| Date of submission by auth rep or employer. |
| String | Date of rehire. |
| String | Employee's updated last name, if applicable. |
| String | Employee's updated first name, if applicable. |
| String | Employee's updated middle initial, if applicable. |
| String | Title of submitted document. |
| String | Number of submitted document. |
| String (format: YYYY-MM-DD) OR "N/A" OR "D/S" | Expiration date of submitted document. |
| Boolean | Did the user use an alternative procedure for reverify? |
| String | Name of employer or auth rep. |
| String | Other information provided upon submission. |
Preparer translator object. Information about the given preparer or translator for an employees I-9.
Attributes | Type | Description |
---|---|---|
preparer_translator.submitted_at | String (format: ISO 8601 ) | Timestamp of when the preparer/translator signed the I-9. |
preparer_translator.date | String (format: YYYY-MM-DD ) | Date the preparer/translator signed the I-9. |
preparer_translator.last_name | String | Preparer/translator's last name. |
preparer_translator.first_name | String | Preparer/translator's first name. |
preparer_translator.middle_initial | String | Preparer/translator's middle initial. |
preparer_translator.address | String | Preparer/translator's street address. |
preparer_translator.city | String | Preparer/translator's city. |
preparer_translator.state | String | Preparer/translator's state abbreviation (e.g. CO). |
preparer_translator.zip | String | Preparer/translator's zip code. |