v1

latestOpenAPI 3.1.02026-07-243113441.2 MB

I-9 Verification

Get an employee's I-9 verification document options

An employee's I-9 verification documents are the documents an employee has provided the employer to verify their identity and authorization to work in the United States. This endpoint returns the possible document options based on the employee's authorization status. These options can then be used to create the I-9 verification documents.

Related guides

I-9 employment verification

scope: i9_authorizations:read

get/v1/employees/{employee_id}/i9_authorization/document_options

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

section'A' | 'A1' | 'A2' | 'A3' | 'B' | 'C' required

The document option's section in the list of acceptable documents on the Form I-9

descriptionstring required

The document option's description

document_typestring required

The document option's document type

document_titlestring[] required

The document option's document titles

common_choiceboolean required

Whether the document is a common choice for I-9 verification