> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.rendr.delivery/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.rendr.delivery/_mcp/server.

# List Locations

Returns the locations for your brand, along with counts of how many locations are in each status.

---

## Endpoint

```
GET {{domain}}/{{tenant_id}}/locations
```

**Authentication:** Bearer token required via the `Authorization` header. The caller needs the `ListStore` permission.

---

## Query Parameters

| Parameter  | Type    | Description                                         |
| ---------- | ------- | --------------------------------------------------- |
| `page`     | Integer | The page of results to return. Defaults to `1`.     |
| `per_page` | Integer | The number of locations per page. Defaults to `10`. |
| `search`   | String  | Optional. A text filter to narrow the results.      |

---

## Response

A successful request returns `200 OK`.

**`200 OK`**

```json title="200 OK"
{
    "data": [ { } ],
    "total": 12,
    "active": 8,
    "pending": 3,
    "disabled": 1
}
```

| Field      | Type   | Description                                |
| ---------- | ------ | ------------------------------------------ |
| `data`     | Array  | The locations on the requested page.       |
| `total`    | Number | The total number of locations.             |
| `active`   | Number | The number of locations that are active.   |
| `pending`  | Number | The number of locations that are pending.  |
| `disabled` | Number | The number of locations that are disabled. |

The count fields cover all of your locations, not just the current page.

### Location statuses

| Status   | Meaning                                                     |
| -------- | ----------------------------------------------------------- |
| Active   | The location is live and available for delivery allocation. |
| Pending  | The location is awaiting activation by Rendr.               |
| Disabled | The location is inactive and not used for deliveries.       |

See [Create a Location](/api-reference/location-management/create-a-location#location-lifecycle) for how locations move from pending to active.