--- title: "Changes to List audiences" method: GET path: "/ad_accounts/{ad_account_id}/audiences" --- # Changes to List audiences `GET /ad_accounts/{ad_account_id}/audiences` > Every recorded change to this operation, newest first. ## Timeline Changed in 10 of 29 revisions. - **2026-06-04** (v5) `b698c180678a`: 2 breaking, 8 info - **2025-12-11** (v5) `79f62f71f05b`: 2 breaking, 8 warning, 29 info - **2025-07-16** (v5) `43134ca41f18`: 2 info - **2025-04-04** (v5) `10f9eba4ad97`: 2 info - **2024-08-14** (v5) `89c27ed39cfd`: 3 warning - **2024-04-23** (v5) `f9321315766f`: 1 breaking - **2024-02-08** (v5) `7529b464d5cb`: 1 info - **2023-02-14** (v5) `be19b77aa78a`: 1 warning - **2022-11-14** (v5) `e041d7b0cef0`: 1 breaking, 7 warning, 1 info - **2022-09-07** (v5) `bd20b6eb152f`: 1 info ## Changes - **2026-06-04** (v5) `b698c180678a`: 2 breaking, 8 info - for the `query` request parameter `order`, default value `ASCENDING` was added - the response's body type changed from no type to `object` for status `200` - added the new optional `query` request parameter `exclude_nca` - removed `#/components/schemas/Paginated, subschema #2` from the response body `allOf` list for the response status `200` - added the non-success response with the status `401` - added the non-success response with the status `403` - added the non-success response with the status `404` - added the non-success response with the status `429` - added the optional property `bookmark` to the response with the `200` status - added the required property `items` to the response with the `200` status - **2025-12-11** (v5) `79f62f71f05b`: 2 breaking, 8 warning, 29 info - the `allOf[subschema #2]/items/items/rule/event_data/currency` response's property type changed from `string` to no type for status `200` - the `allOf[subschema #2]/items/items/rule/event_data/line_items` response's property type changed from `object` to no type for status `200` - removed the optional property `allOf[subschema #2]/items/items/rule/event_data/line_items/product_brand` from the response with the `200` status - removed the optional property `allOf[subschema #2]/items/items/rule/event_data/line_items/product_category` from the response with the `200` status - removed the optional property `allOf[subschema #2]/items/items/rule/event_data/line_items/product_id` from the response with the `200` status - removed the optional property `allOf[subschema #2]/items/items/rule/event_data/line_items/product_name` from the response with the `200` status - removed the optional property `allOf[subschema #2]/items/items/rule/event_data/line_items/product_price` from the response with the `200` status - removed the optional property `allOf[subschema #2]/items/items/rule/event_data/line_items/product_quantity` from the response with the `200` status - removed the optional property `allOf[subschema #2]/items/items/rule/event_data/line_items/product_variant` from the response with the `200` status - removed the optional property `allOf[subschema #2]/items/items/rule/event_data/line_items/product_variant_id` from the response with the `200` status - added `#/components/schemas/Currency` to the `allOf[subschema #2]/items/items/rule/event_data/currency` response property `allOf` list for the response status `200` - added `#/components/schemas/LineItem` to the `allOf[subschema #2]/items/items/rule/event_data/line_items` response property `allOf` list for the response status `200` - removed the `ARS` enum value from the `allOf[subschema #2]/items/items/rule/event_data/currency` response property for the response status `200` - removed the `AUD` enum value from the `allOf[subschema #2]/items/items/rule/event_data/currency` response property for the response status `200` - removed the `BRL` enum value from the `allOf[subschema #2]/items/items/rule/event_data/currency` response property for the response status `200` - removed the `CAD` enum value from the `allOf[subschema #2]/items/items/rule/event_data/currency` response property for the response status `200` - removed the `CHF` enum value from the `allOf[subschema #2]/items/items/rule/event_data/currency` response property for the response status `200` - removed the `CLP` enum value from the `allOf[subschema #2]/items/items/rule/event_data/currency` response property for the response status `200` - removed the `COP` enum value from the `allOf[subschema #2]/items/items/rule/event_data/currency` response property for the response status `200` - removed the `CZK` enum value from the `allOf[subschema #2]/items/items/rule/event_data/currency` response property for the response status `200` - removed the `DKK` enum value from the `allOf[subschema #2]/items/items/rule/event_data/currency` response property for the response status `200` - removed the `EUR` enum value from the `allOf[subschema #2]/items/items/rule/event_data/currency` response property for the response status `200` - removed the `GBP` enum value from the `allOf[subschema #2]/items/items/rule/event_data/currency` response property for the response status `200` - removed the `HKD` enum value from the `allOf[subschema #2]/items/items/rule/event_data/currency` response property for the response status `200` - removed the `HUF` enum value from the `allOf[subschema #2]/items/items/rule/event_data/currency` response property for the response status `200` - removed the `ILS` enum value from the `allOf[subschema #2]/items/items/rule/event_data/currency` response property for the response status `200` - removed the `INR` enum value from the `allOf[subschema #2]/items/items/rule/event_data/currency` response property for the response status `200` - removed the `JPY` enum value from the `allOf[subschema #2]/items/items/rule/event_data/currency` response property for the response status `200` - removed the `KRW` enum value from the `allOf[subschema #2]/items/items/rule/event_data/currency` response property for the response status `200` - removed the `MXN` enum value from the `allOf[subschema #2]/items/items/rule/event_data/currency` response property for the response status `200` - removed the `NOK` enum value from the `allOf[subschema #2]/items/items/rule/event_data/currency` response property for the response status `200` - removed the `NZD` enum value from the `allOf[subschema #2]/items/items/rule/event_data/currency` response property for the response status `200` - removed the `PLN` enum value from the `allOf[subschema #2]/items/items/rule/event_data/currency` response property for the response status `200` - removed the `RON` enum value from the `allOf[subschema #2]/items/items/rule/event_data/currency` response property for the response status `200` - removed the `SEK` enum value from the `allOf[subschema #2]/items/items/rule/event_data/currency` response property for the response status `200` - removed the `SGD` enum value from the `allOf[subschema #2]/items/items/rule/event_data/currency` response property for the response status `200` - removed the `TRY` enum value from the `allOf[subschema #2]/items/items/rule/event_data/currency` response property for the response status `200` - removed the `UNK` enum value from the `allOf[subschema #2]/items/items/rule/event_data/currency` response property for the response status `200` - removed the `USD` enum value from the `allOf[subschema #2]/items/items/rule/event_data/currency` response property for the response status `200` - **2025-07-16** (v5) `43134ca41f18`: 2 info - removed the `VIDEO_VIEW` enum value from the `allOf[subschema #2]/items/items/rule/objective_type/items/` response property for the response status `200` - removed the `WEB_SESSIONS` enum value from the `allOf[subschema #2]/items/items/rule/objective_type/items/` response property for the response status `200` - **2025-04-04** (v5) `10f9eba4ad97`: 2 info - the endpoint scheme security `client_credentials` was added to the API - added the optional property `allOf[subschema #2]/items/items/created_by_company_name` to the response with the `200` status - **2024-08-14** (v5) `89c27ed39cfd`: 3 warning - added the new `INR` enum value to the `allOf[subschema #2]/items/items/rule/event_data/currency` response property for the response status `200` - added the new `TRY` enum value to the `allOf[subschema #2]/items/items/rule/event_data/currency` response property for the response status `200` - added the new `VIDEO_COMPLETION` enum value to the `allOf[subschema #2]/items/items/rule/objective_type/items/` response property for the response status `200` - **2024-04-23** (v5) `f9321315766f`: 1 breaking - the `allOf[subschema #2]/` response's property type changed from no type to `object` for status `200` - **2024-02-08** (v5) `7529b464d5cb`: 1 info - added the new optional `query` request parameter `ownership_type` - **2023-02-14** (v5) `be19b77aa78a`: 1 warning - deleted the `query` request parameter `entity_statuses` - **2022-11-14** (v5) `e041d7b0cef0`: 1 breaking, 7 warning, 1 info - for the `path` request parameter `ad_account_id`, the maxLength was decreased from `19` to `18` - deleted the `query` request parameter `audience_ids` - deleted the `query` request parameter `audience_type` - deleted the `query` request parameter `audience_types` - deleted the `query` request parameter `flatten_rule` - deleted the `query` request parameter `order_by` - deleted the `query` request parameter `search_query` - deleted the `query` request parameter `start_index` - for the `query` request parameter `page_size`, the max was increased from `100.00` to `250.00` - **2022-09-07** (v5) `bd20b6eb152f`: 1 info - endpoint added --- [Operation](https://skmtc.dev/pinterest/apis/pinterest-rest-api/docs/ad_accounts/:ad_account_id/audiences/get.md) - [API](https://skmtc.dev/pinterest/apis/pinterest-rest-api.md) - [Page](https://skmtc.dev/pinterest/apis/pinterest-rest-api/changes/ad_accounts/:ad_account_id/audiences/get)