media_labels_get

# media_labels_get

Read the complete bounded label inventory for an installed OTT, course or shorts app.

## Inputs and supported categories

Provide channelCode and pAppCode. No caller pagination is accepted.

| pAppCode | supportedTypes | Creation limit per category |
| --- | --- | --- |
| `C00002` | COUNTRY, GENRE, AGE_RATING | 100 |
| `C00007` | TOPIC, AGE_RATING | 20 |
| `C00015` | GENERAL | 100 |

## Result and next step

`MEDIA_LABELS` returns labels, supportedTypes, revision and `writesPerformed:false`. Label fields include id, name, type, order, insertedAt, totalPosts and totalSerieses. The adapter validates category/identity uniqueness and a complete response bounded to 1000 labels. If pagination is present, it must establish a complete first page; an incomplete list is not accepted as an editable snapshot.

Use this revision with [media_label_apply](media_label_apply.md). For shorts associations use the observed GENERAL IDs with [media_post_apply](media_post_apply.md). OTT/course ordering is a whole-category operation; shorts ordering is unsupported.

Read the [media workflow guide](../guides/media-workflows.md) for authorization, source-versus-runtime availability and common recovery rules.

## Input example

Illustrative input only. Replace the channel, installed app, identifiers and revision with values obtained for the selected target.

```json
{
  "channelCode": "selected-channel",
  "pAppCode": "C00002"
}
```