Sign in

v1

latestOpenAPI 3.1.02026-07-243113441.2 MB
I-9 Verification

Get an employee's I-9 authorization

An employee's I-9 authorization stores information about an employee's authorization status and I-9 signatures, information required to fill out the Form I-9 for employment eligibility verification.

NOTE: The form_uuid in responses from this endpoint can be used to retrieve the PDF version of the I-9. See the "get employee form PDF" request for more details.

Related guides

scope: i9_authorizations:read

get/v1/employees/{employee_id}/i9_authorization

Path parameters

employee_idstring required

The UUID of the employee

Headers

X-Gusto-API-Version'2026-06-15'

Determines the date-based API version associated with your API call. If none is provided, your application's minimum API version is used.

Response

Success

uuidstring required

The UUID of the I-9 authorization

form_uuidstring nullable

The UUID of the Form associated with this I-9 authorization. Use this with "Employee Forms" API endpoints.

versionstring required

The current version of the object. See the versioning guide for information on how to use this field.

authorization_status'citizen' | 'noncitizen' | 'permanent_resident' | 'alien' required

The employee's authorization status

document_type'uscis_alien_registration_number' | 'form_i94' | 'foreign_passport' nullable

The document's document type

has_document_numberboolean nullable

Whether or not a document_number exists for this document.

expiration_datestring nullable

The document's expiration date

countrystring nullable

The document's country of issuance

employer_signedboolean required

Whether the employer has signed the Form I-9

employee_signedboolean required

Whether the employee has signed the Form I-9

additional_infostring nullable

Any additional notes

alt_procedureboolean nullable

Whether an alternative procedure authorized by DHS to examine documents was used