Get an employee's home addresses

GET {{baseUrl}}/v1/employees/:employee_id/home_addresses

The home address of an employee is used to determine certain tax information about them. Addresses are geocoded on create and update to ensure validity.

Supports home address effective dating and courtesy withholding.

scope: employees:read

HEADERS

KeyDatatypeRequiredDescription
X-Gusto-API-VersionstringDetermines the date-based API version associated with your API call. If none is provided, your application's minimum API version is used.
Acceptstring

RESPONSES

status: OK

[{"uuid":"56260b3d-c375-415c-b77a-75d99f717193","employee_uuid":"7087a288-8349-4632-b92e-bc94fb79f29e","street_1":"644 Fay Vista","street_2":"Suite 842","city":"Richmond","state":"VA","zip":"23218","country":"USA","active":false,"effective_date":"2021-01-01","courtesy_withholding":true},{"uuid":"d9f74049-8769-4fba-8e0f-eceef2da4e6b","employee_uuid":"7087a288-8349-4632-b92e-bc94fb79f29e","street_1":"100 5th Ave","street_2":"Suite 555","city":"New York","state":"NY","zip":"10001","country":"USA","active":true,"effective_date":"2022-03-03","courtesy_withholding":true}]