---
title: "Get all company locations"
method: GET
path: "/v1/companies/{company_id}/locations"
tags: ["Locations"]
---

# Get all company locations

`GET /v1/companies/{company_id}/locations`

Retrieves all company locations (addresses) associated with a company: mailing addresses, filing
addresses, or work locations. A single address may serve multiple, or all, purposes.

Since all company locations are subsets of locations, use the Locations endpoints to
[get](https://docs.gusto.com/embedded-payroll/reference/get-v1-locations-location_id) or [update](https://docs.gusto.com/embedded-payroll/reference/put-v1-locations-location_id) an individual record.

scope: `companies:read`

## Path parameters

- `company_id` string, required

## Query parameters

- `page` integer
- `per` integer

## Headers

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

## Response `200`

Success

- Location[]
  - `uuid` string, required — The UUID of the location object.
  - `version` string — The current version of the object. See the [versioning guide](https://docs.gusto.com/embedded-payroll/docs/idempotency) for information on how to use this field.
  - `company_uuid` string — The UUID for the company to which the location belongs. Only included if the location belongs to a company.
  - `phone_number` string — The phone number for the location. Required for company locations. Optional for employee locations.
  - `street_1` string
  - `street_2` string, nullable
  - `city` string
  - `state` string
  - `zip` string
  - `country` string
  - `mailing_address` boolean — Specifies if the location is the company's mailing address. Only included if the location belongs to a company.
  - `filing_address` boolean — Specifies if the location is the company's filing address. Only included if the location belongs to a company.
  - `created_at` string — Datetime for when location is created
  - `updated_at` string — Datetime for when location is updated
  - `active` boolean — The status of the location. Inactive locations have been deleted, but may still have historical data associated with them.
  - `inactive` boolean — The status of the location. Inactive locations have been deleted, but may still have historical data associated with them.

## Other responses

- `404` — Not Found

---

[API](https://skmtc.net/gusto/apis/gusto-api.md) · [All operations](https://skmtc.net/gusto/apis/gusto-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/gusto/gusto-api/revisions/826dfa57fb3b/schema)