v29

latestOpenAPI 3.0.3MITraw.githubusercontent.com2026-06-042661,1122.5 MB
labels

List labels

Closed beta

See a list of labels for assets that your account owns, and filter the list by different criteria. If no filter is provided, it will default to labels associated with the ad account id.

get/ad_accounts/{ad_account_id}/labels

Path parameters

ad_account_idstring required

Unique identifier of an ad account.

Query parameters

campaign_idsCampaignIdType[]

List of Campaign Ids to use to filter the results.

label_idsQueryLabelIdsItems[]

List of Label Ids to use to filter the results.

entity_statusesQueryLabelEntityStatusesItems[]

Label entity status

label_typesQueryLabelTypesItems[]

Label type.

bookmarkstring

Cursor used to fetch the next page of items

page_sizeinteger

Maximum number of items to include in a single page. See documentation on Pagination for more information.

Response

The request has succeeded.

bookmarkstring nullable