Get company locations

GET {{baseUrl}}/v1/companies/:company_id/locations?page=<number>&per=<number>

Company locations represent all addresses associated with a company. These can be filing addresses, mailing addresses, and/or work locations; one address may serve multiple, or all, purposes.

Since all company locations are subsets of locations, retrieving or updating an individual record should be done via the locations endpoints.

scope: companies:read

Request Params

KeyDatatypeRequiredDescription
pagestringThe page that is requested. When unspecified, will load all objects unless endpoint forces pagination.
perstringNumber of objects per page. For majority of endpoints will default to 25

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

[{&quot;company_uuid&quot;:&quot;6bf7807c-a5a0-4f4d-b2e7-3fbb4b2299fb&quot;,&quot;version&quot;:&quot;7d9753112507b9dda4fb97910f39b06e&quot;,&quot;phone_number&quot;:&quot;5825710808&quot;,&quot;uuid&quot;:&quot;04552eb9-7829-4b18-ae96-6983552948df&quot;,&quot;street_1&quot;:&quot;412 Kiera Stravenue&quot;,&quot;street_2&quot;:&quot;Suite 391&quot;,&quot;city&quot;:&quot;San Francisco&quot;,&quot;state&quot;:&quot;CA&quot;,&quot;zip&quot;:&quot;94107&quot;,&quot;country&quot;:&quot;USA&quot;,&quot;active&quot;:true,&quot;filing_address&quot;:false,&quot;mailing_address&quot;:false,&quot;created_at&quot;:&quot;2023-09-12T16:42:25.000-07:00&quot;,&quot;updated_at&quot;:&quot;2023-09-12T16:42:25.000-07:00&quot;},{&quot;company_uuid&quot;:&quot;6bf7807c-a5a0-4f4d-b2e7-3fbb4b2299fb&quot;,&quot;version&quot;:&quot;15e6b9680e00f3122729e64e3cef3224&quot;,&quot;phone_number&quot;:&quot;2866070827&quot;,&quot;uuid&quot;:&quot;fa94a2fd-11a8-4024-87ff-85c587d9d2b4&quot;,&quot;street_1&quot;:&quot;644 Fay Vista&quot;,&quot;street_2&quot;:&quot;Suite 842&quot;,&quot;city&quot;:&quot;Richmond&quot;,&quot;state&quot;:&quot;VA&quot;,&quot;zip&quot;:&quot;23218&quot;,&quot;country&quot;:&quot;USA&quot;,&quot;active&quot;:true,&quot;filing_address&quot;:false,&quot;mailing_address&quot;:false,&quot;created_at&quot;:&quot;2023-09-12T16:42:25.000-07:00&quot;,&quot;updated_at&quot;:&quot;2023-09-12T16:42:25.000-07:00&quot;}]