Manage company locations

Company locations represent all addresses associated with a company: these can include filing addresses, mailing addresses, and work locations. A single address can serve multiple purposes.

Set up a company location

Follow the steps below to set up a company location.

1. Create a company location

Use the POST /v1/companies/{company_id}/locations endpoint to create a new location associated with a company.

Sample request

curl --request POST \
     --url https://api.gusto-demo.com/v1/companies/company_id/locations \
     --header 'X-Gusto-API-Version: 2025-06-15' \
     --header 'accept: application/json' \
     --header 'authorization: Bearer ual5eR_MS_9ghz0HS6ah4NBbYaUGAhqlVl1KqFYTmsk' \
     --header 'content-type: application/json' \
     --data '{
  "phone_number": "8009360383",
  "street_1": "425 2nd Street",
  "street_2": "Suite 602",
  "city": "San Francisco",
  "state": "CA",
  "zip": "94107"
}'

Sample response

{
  "created_at": "2025-07-24T00:32:26.000-07:00",
  "updated_at": "2025-07-24T00:32:26.000-07:00",
  "company_uuid": "b8f888ff-9dda-411a-b83f-0b31187f6299",
  "version": "40ab77b5816168f12fb89e8352d23964",
  "uuid": "5d7e124a-bd8b-40c2-a79c-ec5b6ab0f61f",
  "street_1": "425 2nd Street",
  "street_2": "Suite 602",
  "city": "San Francisco",
  "state": "CA",
  "zip": "94107",
  "country": "USA",
  "active": true,
  "phone_number": "8009360383",
  "filing_address": false,
  "mailing_address": false
}

2. Get the minimum wage for the company location

Next, you'll need to retrieve a location's applicable minimum wages, since minimum wage requirements can vary significantly by location.

This step is important because failing to account for location-specific wage rules may result in underpayment, non-compliance penalties, or legal exposure. By calling this endpoint, you ensure payroll calculations meet federal, state, and local compliance standards for the specific location.

Retrieve a location's minimum wages using the GET /v1/locations/{location_uuid}/minimum_wages endpoint.

Sample request

curl --request GET \
     --url https://api.gusto-demo.com/v1/locations/location_uuid/minimum_wages \
     --header 'X-Gusto-API-Version: 2024-04-01' \
     --header 'accept: application/json' \
     --header 'authorization: Bearer ual5eR_MS_9ghz0HS6ah4NBbYaUGAhqlVl1KqFYTmsk'

Sample response

The response will contain federal, state, and local minimum wage information for that location.

[
  {
    "uuid": "b6b4d18c-4957-44e1-99e4-12723e59471b",
    "authority": "City",
    "wage": "22.5",
    "wage_type": "Regular",
    "effective_date": "2025-07-01",
    "notes": "Public Entities MCO rate. Ordinance covers most City service contractors as well as tenants at the San Francisco International Airport."
  },
  {
    "uuid": "7f8319ed-247e-49cd-bb94-3533ae8efdaa",
    "authority": "State",
    "wage": "24.0",
    "wage_type": "Regular",
    "effective_date": "2025-07-01",
    "notes": "Covered Health Care Facilities run by Large Counties (more than five million people as of 1/1/23)"
  },
  {
    "uuid": "0ee4d15a-fa0e-4ce1-bb4c-9614ede230dc",
    "authority": "Federal",
    "wage": "13.3",
    "wage_type": "Regular",
    "effective_date": "2025-01-01",
    "notes": "Minimum wage federal contractors pay workers performing work on or in connection with existing covered contracts"
  }
]

Migrate a company location

You may need to update or migrate a company’s location record when it moves to a new address or consolidates multiple locations.

To do this, update the location data by using the PUT /v1/locations/{location_id} endpoint.

📘
This action does not create a new location. It updates the existing one in place.
Ensure this change reflects the company’s actual physical or tax filing move.

Sample request

curl --request PUT \
     --url https://api.gusto-demo.com/v1/locations/location_id \
     --header 'X-Gusto-API-Version: 2024-04-01' \
     --header 'accept: application/json' \
     --header 'content-type: application/json'

Sample response

{
  "created_at": "2025-07-24T00:32:26.000-07:00",
  "updated_at": "2025-07-24T00:32:26.000-07:00",
  "company_uuid": "b8f888ff-9dda-411a-b83f-0b31187f6299",
  "version": "93826c35c331846f86584c61001cd695",
  "uuid": "5d7e124a-bd8b-40c2-a79c-ec5b6ab0f61f",
  "street_1": "300 3rd Street",
  "street_2": "Apartment 318",
  "city": "San Francisco",
  "state": "CA",
  "zip": "94107",
  "country": "USA",
  "active": true,
  "phone_number": "8009360383",
  "filing_address": false,
  "mailing_address": false
}