---
api: 'Merchant API'
---

# Retrieve location list

Retrieve a list of locations registered for the merchant.

:::note [Default behavior]
Without the `type` query parameter, this endpoint returns only **online** locations by default. To retrieve physical locations, you must explicitly specify `type=physical` in the query parameters.
:::

## Endpoint

GET `/api/locations`

## Parameters

### query parameters

- `type` (enum, optional)
  Filter the list by location type.
  Possible enum values:

  - `online`
  - `physical`

## Returns

### 200

OK

#### Response attributes


## Error responses

| HTTP status code | Description |
| --- | --- |
| 401 | Unauthorized |