---
title: "Returns one location of a customer."
method: GET
path: "/api/v1/customers/{id}/locations/{locationId}"
tags: ["Customers"]
---

# Returns one location of a customer.

`GET /api/v1/customers/{id}/locations/{locationId}`

## Request

- Base URL: `https://app.flexonthejob.com`
- URL: `https://app.flexonthejob.com/api/v1/customers/{id}/locations/{locationId}`
- Auth: HTTP bearer

Send the previous `ETag` as `If-None-Match` to receive `304 Not Modified` when unchanged; send it as `If-Match` on a PATCH to avoid overwriting a concurrent edit.

## Path parameters

- `id` integer, required
- `locationId` integer, required

## Response `200`

The location, with an `ETag` header.

- CustomerLocationDto: An additional address / job site belonging to a customer, as returned by `GET /api/v1/customers/{id}/locations`. Jobs can reference one of these as the site to work at; the customer's primary address is on the customer itself.
  - `id` integer: Numeric id of the location. Stable within this organization.
  - `syncId` string, uuid: Globally unique sync id (GUID). Use it as the `after` pagination cursor.
  - `customerId` integer: Id of the owning customer (matches the `{id}` in the URL).
  - `name` string: Label given to the location, e.g. `"Main Office"` or `"Rental Property 1"`.
  - `address` string, nullable: Street address line 1.
  - `address2` string, nullable: Street address line 2 (suite, unit).
  - `city` string, nullable: City.
  - `state` string, nullable: State / province.
  - `postalCode` string, nullable: ZIP / postal code.
  - `country` string, nullable: Country.
  - `isMailingAddress` boolean: True when this is the customer's mailing address.
  - `isActive` boolean: False when the location has been retired and should not be offered for new jobs.
  - `notes` string, nullable: Free-text notes about the site (gate codes, parking), max 500 characters.
  - `createdAt` string, date-time: UTC creation timestamp.
  - `updatedAt` string, date-time, nullable: UTC timestamp of the last edit; null when never edited.

## Other responses

- `304`: Unchanged since the supplied `If-None-Match`.
- `401`: Unauthorized
- `403`: Forbidden
- `404`: No such customer in this organization, or the location belongs to another customer.
- `429`: Too Many Requests

---

[API](https://skmtc.dev/flexonthejob/apis/flex-api.md) · [All operations](https://skmtc.dev/flexonthejob/apis/flex-api/llms.txt) · [OpenAPI document](https://skmtc.dev/flexonthejob/apis/flex-api/revisions/19c8f4d27acf?raw)