---
title: "Get location"
method: GET
path: "/v1/locations/{location}"
tags: ["Location"]
---

# Get location

`GET /v1/locations/{location}`

Retrieve a single location by ID for the authenticated business.
Returns `404` if the location does not exist or belongs to another business.

## Path parameters

- `location` string, uuid, required

## Headers

- `X-BUSINESS-API-KEY` string, required

## Response `200`

Location retrieved successfully

- object
  - `id` string, uuid, required — Location ID
  - `business_id` string, uuid, required — Business that owns this location
  - `name` string, required — Name of the location
  - `street` string, required — Street address
  - `city` string, required — City
  - `state` string, required — State or region
  - `country` string, required — Country code or name
  - `postal_code` string, required — Postal code
  - `active` boolean, required — Whether the location is active
  - `pickups` object[] — Pickup configurations linked to this location (empty when not loaded)
  - `created_at` string, date-time
  - `updated_at` string, date-time

## Other responses

- `401` — Missing or invalid API key / OAuth token
- `404` — Location not found or does not belong to this business

---

[API](https://skmtc.net/hitpayapp/apis/hitpay-api.md) · [All operations](https://skmtc.net/hitpayapp/apis/hitpay-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/hitpayapp/hitpay-api/versions/6aae1a736990/schema)