v1

latestOpenAPI 3.1.02026-07-243113441.2 MB

Employee Addresses

Get an employee's work addresses

Returns a list of an employee's work addresses. Each address includes its effective date and a boolean signifying if it is the currently active work address.

scope: employees:read

get/v1/employees/{employee_id}/work_addresses

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

List of employee work addresses

uuidstring required

The unique identifier of this work address.

effective_datestring

The date the employee began working at this location.

activeboolean

Signifies if this address is the active work address for the current date

location_uuidstring

UUID reference to the company location for this work address.

employee_uuidstring

UUID reference to the employee for this work address.

versionstring required

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

street_1string

street_2string nullable

citystring

statestring

zipstring

countrystring