--- title: "Changes to Get audience" method: GET path: "/ad_accounts/{ad_account_id}/audiences/{audience_id}" --- # Changes to Get audience `GET /ad_accounts/{ad_account_id}/audiences/{audience_id}` > Every recorded change to this operation, newest first. ## Timeline Changed in 7 of 29 revisions. - **2026-06-04** (v5) `b698c180678a`: 5 breaking, 1 warning, 19 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 - **2022-11-14** (v5) `e041d7b0cef0`: 1 breaking, 1 warning - **2022-09-07** (v5) `bd20b6eb152f`: 1 info ## Changes - **2026-06-04** (v5) `b698c180678a`: 5 breaking, 1 warning, 19 info - response property `rule/percentage` list-of-types was widened by adding types `string` to media type `application/json` of response `200` - response property `rule/visitor_source_id` list-of-types was widened by adding types `array` to media type `application/json` of response `200` - the `audience_type` response's property type changed from `string` to no type for status `200` - the `rule/seed_id` response's property type changed from `array` to no type for status `200` - the `status` response's property type changed from `string` to no type for status `200` - added the new `SALES` enum value to the `rule/objective_type/items/` response property for the response status `200` - added the non-success response with the status `400` - 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 `429` - added the optional property `is_nca` to the response with the `200` status - the response optional property `created_by_company_name` became read-only for the status `200` - the response optional property `created_timestamp` became read-only for the status `200` - the response optional property `size` became read-only for the status `200` - the response optional property `status` became read-only for the status `200` - the response optional property `type` became read-only for the status `200` - the response optional property `updated_timestamp` became read-only for the status `200` - added `#/components/schemas/AudienceStatus` to the `status` response property `allOf` list for the response status `200` - added `#/components/schemas/AudienceType` to the `audience_type` response property `allOf` list for the response status `200` - added `subschema #1, subschema #2` to the `rule/seed_id` response property `anyOf` list for the response status `200` - the response property `id` became required for the status `200` - the `rule/ad_id/items/` response's property pattern `^\d+$` was removed for the status `200` - the `rule/campaign_id/items/` response's property pattern `^\d+$` was removed for the status `200` - the `rule/pin_id/items/` response's property pattern `^\d+$` was removed for the status `200` - the `rule/visitor_source_id` response's property pattern `^\d+$` was removed for the status `200` - **2025-12-11** (v5) `79f62f71f05b`: 2 breaking, 8 warning, 29 info - the `rule/event_data/currency` response's property type changed from `string` to no type for status `200` - the `rule/event_data/line_items` response's property type changed from `object` to no type for status `200` - removed the optional property `rule/event_data/line_items/product_brand` from the response with the `200` status - removed the optional property `rule/event_data/line_items/product_category` from the response with the `200` status - removed the optional property `rule/event_data/line_items/product_id` from the response with the `200` status - removed the optional property `rule/event_data/line_items/product_name` from the response with the `200` status - removed the optional property `rule/event_data/line_items/product_price` from the response with the `200` status - removed the optional property `rule/event_data/line_items/product_quantity` from the response with the `200` status - removed the optional property `rule/event_data/line_items/product_variant` from the response with the `200` status - removed the optional property `rule/event_data/line_items/product_variant_id` from the response with the `200` status - added `#/components/schemas/Currency` to the `rule/event_data/currency` response property `allOf` list for the response status `200` - added `#/components/schemas/LineItem` to the `rule/event_data/line_items` response property `allOf` list for the response status `200` - removed the `ARS` enum value from the `rule/event_data/currency` response property for the response status `200` - removed the `AUD` enum value from the `rule/event_data/currency` response property for the response status `200` - removed the `BRL` enum value from the `rule/event_data/currency` response property for the response status `200` - removed the `CAD` enum value from the `rule/event_data/currency` response property for the response status `200` - removed the `CHF` enum value from the `rule/event_data/currency` response property for the response status `200` - removed the `CLP` enum value from the `rule/event_data/currency` response property for the response status `200` - removed the `COP` enum value from the `rule/event_data/currency` response property for the response status `200` - removed the `CZK` enum value from the `rule/event_data/currency` response property for the response status `200` - removed the `DKK` enum value from the `rule/event_data/currency` response property for the response status `200` - removed the `EUR` enum value from the `rule/event_data/currency` response property for the response status `200` - removed the `GBP` enum value from the `rule/event_data/currency` response property for the response status `200` - removed the `HKD` enum value from the `rule/event_data/currency` response property for the response status `200` - removed the `HUF` enum value from the `rule/event_data/currency` response property for the response status `200` - removed the `ILS` enum value from the `rule/event_data/currency` response property for the response status `200` - removed the `INR` enum value from the `rule/event_data/currency` response property for the response status `200` - removed the `JPY` enum value from the `rule/event_data/currency` response property for the response status `200` - removed the `KRW` enum value from the `rule/event_data/currency` response property for the response status `200` - removed the `MXN` enum value from the `rule/event_data/currency` response property for the response status `200` - removed the `NOK` enum value from the `rule/event_data/currency` response property for the response status `200` - removed the `NZD` enum value from the `rule/event_data/currency` response property for the response status `200` - removed the `PLN` enum value from the `rule/event_data/currency` response property for the response status `200` - removed the `RON` enum value from the `rule/event_data/currency` response property for the response status `200` - removed the `SEK` enum value from the `rule/event_data/currency` response property for the response status `200` - removed the `SGD` enum value from the `rule/event_data/currency` response property for the response status `200` - removed the `TRY` enum value from the `rule/event_data/currency` response property for the response status `200` - removed the `UNK` enum value from the `rule/event_data/currency` response property for the response status `200` - removed the `USD` enum value from the `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 `rule/objective_type/items/` response property for the response status `200` - removed the `WEB_SESSIONS` enum value from the `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 `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 `rule/event_data/currency` response property for the response status `200` - added the new `TRY` enum value to the `rule/event_data/currency` response property for the response status `200` - added the new `VIDEO_COMPLETION` enum value to the `rule/objective_type/items/` response property for the response status `200` - **2022-11-14** (v5) `e041d7b0cef0`: 1 breaking, 1 warning - for the `path` request parameter `ad_account_id`, the maxLength was decreased from `19` to `18` - for the `path` request parameter `audience_id`, the maxLength was set to `18` - **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/:audience_id/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/:audience_id/get)