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

# List locations

`GET /locations`

Retrieve a list of locations based on provided filters.

## Query parameters

- `isActive` boolean
- `locationIds` string[]
- `locationType` string
- `externalId` string

## Response `200`

Successful response

- object[]
  - `id` string, uuid, required
  - `name` string, required
  - `externalId` string, nullable
  - `administrativeAreaId` string, uuid, nullable, required
  - `validUntil` string, date-time, nullable, required
  - `locationType` string, nullable, required

## Other responses

- `400` — Invalid input data
- `401` — Authorization not provided
- `403` — Insufficient access
- `404` — Not found
- `500` — Internal server error

---

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