---
title: "List locations"
method: GET
path: "/locations"
tags: ["Locations"]
---

# List locations

`GET /locations`

## Request

- Base URL: `https://simpledock.ai/api/v1`
- URL: `https://simpledock.ai/api/v1/locations`
- Auth: HTTP bearer

List every location (facility) the API key's organization can see. Start here: the returned `id` is the `locationId` every other endpoint takes.

## Response `200`

Success

- object
  - `data` Location[], required
    - `id` string
    - `name` string
    - `slug` string
    - `timezone` string
    - `address` string, nullable
    - `city` string, nullable
    - `state` string, nullable
    - `zip` string, nullable
    - `appointmentApprovalRequired` boolean
    - `createdAt` string, date-time

## Other responses

- `401`: Unauthorized
- `402`: Payment required — a Pro feature or a Free plan limit
- `403`: Forbidden — key is missing the required scope
- `429`: Rate limited — slow down and retry after Retry-After

---

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