---
title: "List all labels"
type: reference
method: GET
path: /rest-api/label/list.do
tag: "Labels"
---

# List all labels

`GET https://YOUR-NETWORK-DOMAIN/rest-api/label/list.do`

Retrieves all configured labels in the system, with optional search, sorting, and pagination controlled via the 'sort', 'limit', 'offset' and 'search' parameters. If no sort field is specified, results are sorted by 'id'. If no limit is specified, all labels are returned. The response is a JSON array of simplified label objects containing 'id' and 'value' fields. Requires the LABELS_MANAGEMENT permission.

## Query params

| Name | Type | Required | Example | Description |
|---|---|---|---|---|
| `activeOnly` | boolean | no | `true` | When true, return only active (non-deleted) records |
| `dir` | string | no | `ASC` | Sort direction: ASC or DESC |
| `labels` | array<integer> | no | `101,102` | Filter by label IDs |
| `limit` | integer | no | `50` | Maximum number of records to return per page |
| `multisort` | array<string> | no | `[{"property":"id","direction":"ASC"}]` | Multi-column sort configuration as a JSON array of objects with 'property' and 'direction' fields |
| `name` | string | no | `my-campaign` | Filter by entity name |
| `onlyData` | boolean | no | `false` | When true, return only data rows without metadata |
| `onlyTotal` | boolean | no | `false` | When true, return only the total count without data rows |
| `query` | string | no | `test` | Search query string to filter results by name or other searchable fields |
| `role` | integer | no | `3` | Filter by user role ID |
| `sort` | string | no | `id` | Field name to sort results by |
| `start` | integer | no | `0` | Pagination offset (0-based index of the first record to return) |

## Responses

- `200` — Labels retrieved successfully
- `400` — Bad request — invalid or missing parameters
- `401` — Authentication error
- `403` — No access to labels management

## Example request

```bash
curl --request GET \
  --url 'https://YOUR-NETWORK-DOMAIN/rest-api/label/list.do?name=my-campaign&activeOnly=true&dir=ASC' \
  --header 'X-Api-Key: YOUR_API_KEY'
```

Source: https://epom.com/ad-server/docs/api/labels/get-label-list