---
title: "Get label by ID"
type: reference
method: GET
path: /rest-api/label/{labelId}.do
tag: "Labels"
---

# Get label by ID

`GET https://YOUR-NETWORK-DOMAIN/rest-api/label/{labelId}.do`

Retrieves a single label by its unique numeric identifier. The response includes full label details: 'id', 'value', 'defaultLabel' flag, 'defaultLabelObjectType' (1=Banner, 2=Placement), and 'defaultLabelPlacementTypes' (array of placement type IDs). Requires the LABELS_MANAGEMENT permission.

## Path params

| Name | Type | Required | Example | Description |
|---|---|---|---|---|
| `labelId` | integer | yes | `100` | Unique numeric identifier of the label to retrieve |

## Responses

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

## Example request

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

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