---
title: "List locations for authenticated business flows"
method: GET
path: "/v3/locations"
tags: ["Locations"]
---

# List locations for authenticated business flows

`GET /v3/locations`

Requires the `order:create` scope. Retrieve a cursor-paginated list of locations with optional search.

## Query parameters

- `page_size` integer
- `next_cursor` string
- `previous_cursor` string
- `search` string

## Response `200`

Locations list

- ListLocationsResponseBody — Paginated list payload for v3.
  - `data` Location[], required
    - `id` integer, required — Location ID
    - `subdistrict_name` string, required — Subdistrict name
    - `city_name` string, required — City name
    - `province_name` string, required — Province name
    - `display` string, required — Display name
  - `is_paginated` true, required
  - `has_next` boolean
  - `page_size` integer

## Other responses

- `401` — Unauthorized
- `403` — Forbidden

---

[API](https://skmtc.net/scalev/apis/nexus-commerce-api.md) · [All operations](https://skmtc.net/scalev/apis/nexus-commerce-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/scalev/nexus-commerce-api/revisions/730030bd6477/schema)