ad_accounts14

ad_groups13

ads10

advanced_auction2

audience_insights2

audience_sharing7

audiences4

billing11

boards11

bulk3

business_access_assets12

business_access_invite6

business_access_relationships9

campaigns8

catalog_feeds8

catalog_items3

catalog_product_groups10

catalog_reports3

catalog_supplemental7

catalogs3

conversion_deletion_requests4

conversion_eqs1

conversion_events1

conversion_tags5

conversions4

customer_list_uploads3

customer_lists4

customer_segment3

integrations7

keywords5

labels5

lead_ads4

lead_forms5

leads_export2

media3

msot_events1

notification1

oauth3

order_lines2

pins8

product_group_promotions5

product_tags3

promotions5

resources6

schedules3

search3

targeting_template3

terms2

terms_of_service1

trends4

user_account14

labels

List labels

Changed on Jun 4, 2026

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

Request

Base URL
https://api.pinterest.com/v5
Auth
OAuth 2
Authorization codehttps://www.pinterest.com/oauth/
Token URLhttps://api.pinterest.com/v5/oauth/token
Scopesads:read
TypeScript
https://skmtc.dev/pinterest/apis/pinterest-rest-api/docs/ad_accounts/:ad_account_id/labels/get.ts
A function with typed inputs. Its response is checked against the schema.

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

Changes

Jun 4, 2026v5b698c180678a Revision changes
- breaking
  the response's body type changed from no type to object for status
- info
  removed subschema #2 from the response body allOf list for the response status
- info
  added the non-success response with the status
- info
  added the non-success response with the status
- info
  added the non-success response with the status
- info
  added the non-success response with the status
- info
  added the optional property to the response with the status
- info
  added the required property to the response with the status
Oct 16, 2025v514c297539b64 Revision changes
- breaking
  the response property ////// became nullable for the status
- breaking
  the response property ////// became nullable for the status
- breaking
  the response property ////// became nullable for the status
- breaking
  the response property ///// became nullable for the status
- breaking
  the response property ///// became nullable for the status
- breaking
  the response property ///// became nullable for the status
- warning
  added the new ACTIVE enum value to the ////// response property for the response status
- warning
  added the new ACTIVE enum value to the ///// response property for the response status
- warning
  added the new ARCHIVED enum value to the ////// response property for the response status
- warning
  added the new ARCHIVED enum value to the ///// response property for the response status
- warning
  added the new BRAND enum value to the ////// response property for the response status
- warning
  added the new BRAND enum value to the ///// response property for the response status
- warning
  added the new CAMPAIGN enum value to the ////// response property for the response status
- warning
  added the new CAMPAIGN enum value to the ///// response property for the response status
- warning
  added the new CUSTOM enum value to the ////// response property for the response status
- warning
  added the new CUSTOM enum value to the ///// response property for the response status
- warning
  added the new undefined enum value to the ////// response property for the response status
- warning
  added the new undefined enum value to the ////// response property for the response status
- warning
  added the new undefined enum value to the ////// response property for the response status
- warning
  added the new undefined enum value to the ///// response property for the response status
- warning
  added the new undefined enum value to the ///// response property for the response status
- warning
  added the new undefined enum value to the ///// response property for the response status
- info
  for the query request parameter campaign_ids, the maxItems was increased from 100 to 250
- info
  for the query request parameter label_ids, the maxItems was increased from 100 to 250

Operation history (4 revisions)