---
title: "Ad labels"
method: GET
path: "/v1/ads/labels"
tags: ["Ad Accounts"]
---

# Ad labels

`GET /v1/ads/labels`

Lists the ad account's organizational labels (Meta's `/act_X/adlabels`), rows returned
verbatim (id, name, created/updated time).

## Query parameters

- `accountId` string, required
- `adAccountId` string, required
- `limit` integer
- `after` string

## Response `200`

Ad labels (raw Meta shape)

- object
  - `adAccountId` string
  - `data` object[]
  - `paging` object
    - `after` string, nullable — Cursor for the next page; null when exhausted.

## Other responses

- `400` — Invalid input, or Meta rejected the query
- `401` — Unauthorized
- `501` — Only supported on Meta (facebook/instagram)

---

[API](https://skmtc.net/zernio/apis/zernio-api.md) · [All operations](https://skmtc.net/zernio/apis/zernio-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/zernio/zernio-api/versions/51932b099b2f/schema)