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

# Delete location

`DELETE /v1/locations/{location}`

Permanently delete a location. The location must be **inactive** before deletion — call
`PATCH /v1/locations/{location}` with `{"active": false}` first.

Deletion is blocked if the location is still active, or if it is the last remaining location.

## Path parameters

- `location` string, uuid, required

## Headers

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

## Response `204`

Location deleted successfully

## Other responses

- `400` — Location is still active, or is the last remaining location
- `401` — Missing or invalid API key / OAuth token
- `403` — Authenticated user cannot manage locations
- `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)