# List locations

> `GET https://api.kustom.co/ipp/v1/locations`

Returns a paginated list of locations belonging to the authenticated merchant.

## Parameters

- `page_number` (integer, query) — Zero-based page number. Defaults to 0.
- `page_size` (integer, query) — Page size. Defaults to 20.

## Responses

### 200

Locations retrieved successfully.

`application/json`

- `content[]` (array<any>)
- `total_elements` (integer)
- `total_pages` (integer)
- `page_number` (integer)
- `page_size` (integer)
- `first` (boolean)
- `last` (boolean)

```json
{
  "content": [
    "<string>"
  ],
  "total_elements": 0,
  "total_pages": 0,
  "page_number": 0,
  "page_size": 0,
  "first": false,
  "last": false
}
```

### 400

Missing or invalid merchant ID header.

`application/json`

### 401

Missing or invalid credentials.

`application/json`