---
title: "List all labels (deprecated)"
type: reference
method: GET
path: /rest-api/labels.do
tag: "Labels"
---

# List all labels (deprecated)

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

Returns all configured labels in the system as a JSON array. Each label object contains an 'id' and a 'value' field. This endpoint is deprecated — use GET /rest-api/label/list.do and the other /rest-api/label/ endpoints instead. Requires authentication but does not enforce additional permission checks.

## Responses

- `200` — Successfully retrieved labels
- `400` — Bad request — invalid or missing parameters
- `401` — Unauthorized - authentication error
- `403` — Forbidden — insufficient permissions

## Example request

```bash
curl --request GET \
  --url 'https://YOUR-NETWORK-DOMAIN/rest-api/labels.do' \
  --header 'X-Api-Key: YOUR_API_KEY'
```

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