--- title: "Changes to List ad groups" method: GET path: "/ad_accounts/{ad_account_id}/ad_groups" --- # Changes to List ad groups `GET /ad_accounts/{ad_account_id}/ad_groups` > Every recorded change to this operation, newest first. ## Timeline Changed in 17 of 29 revisions. - **2026-06-04** (v5) `b698c180678a`: 2 breaking, 7 info - **2025-12-11** (v5) `537bde5a50b1`: 2 breaking - **2025-12-10** (v5) `6768e3ca1ffa`: 2 info - **2025-10-16** (v5) `14c297539b64`: 2 info - **2025-08-12** (v5) `8fb7ab040159`: 1 info - **2025-07-16** (v5) `43134ca41f18`: 1 info - **2025-04-04** (v5) `10f9eba4ad97`: 2 warning, 4 info - **2024-04-23** (v5) `f9321315766f`: 1 breaking, 1 warning, 2 info - **2024-02-08** (v5) `7529b464d5cb`: 4 warning, 3 info - **2023-08-17** (v5) `0ff12596bafd`: 1 warning - **2023-05-12** (v5) `689b4b267639`: 16 info - **2023-02-14** (v5) `be19b77aa78a`: 7 breaking, 1 warning, 1 info - **2022-11-14** (v5) `e041d7b0cef0`: 1 breaking, 1 info - **2022-09-07** (v5) `bd20b6eb152f`: 1 warning, 1 info - **2022-07-11** (v5) `0d5998752011`: 1 breaking, 4 info - **2021-12-16** (v5) `2a34d1d22a47`: 1 warning - **2021-11-05** (v5) `8583f6373a80`: 5 breaking, 1 info ## Changes - **2026-06-04** (v5) `b698c180678a`: 2 breaking, 7 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` - 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) `537bde5a50b1`: 2 breaking - the `allOf[subschema #2]/items/items/allOf[#/components/schemas/AdGroupCommon]/targeting_spec/AUDIENCE_EXCLUDE/items/` response property's minItems was decreased from `100` to `0` for the response status `200` - the `allOf[subschema #2]/items/items/allOf[#/components/schemas/AdGroupCommon]/targeting_spec/AUDIENCE_INCLUDE/items/` response property's minItems was decreased from `100` to `0` for the response status `200` - **2025-12-10** (v5) `6768e3ca1ffa`: 2 info - added the optional property `allOf[subschema #2]/items/items/allOf[#/components/schemas/AdGroupCommon]/targeting_spec/MAXIMUM_AGE` to the response with the `200` status - added the optional property `allOf[subschema #2]/items/items/allOf[#/components/schemas/AdGroupCommon]/targeting_spec/MINIMUM_AGE` to the response with the `200` status - **2025-10-16** (v5) `14c297539b64`: 2 info - for the `query` request parameter `ad_group_ids`, the maxItems was increased from `100` to `250` - for the `query` request parameter `campaign_ids`, the maxItems was increased from `100` to `250` - **2025-08-12** (v5) `8fb7ab040159`: 1 info - added the optional property `allOf[subschema #2]/items/items/allOf[#/components/schemas/AdGroupCommon]/optimization_goal_metadata/allOf[#/components/schemas/OptimizationGoalMetadata]/conversion_tag_v3_goal_metadata/reporting_event` to the response with the `200` status - **2025-07-16** (v5) `43134ca41f18`: 1 info - added the optional property `allOf[subschema #2]/items/items/allOf[#/components/schemas/AdGroupCommon]/promotion_application_level` to the response with the `200` status - **2025-04-04** (v5) `10f9eba4ad97`: 2 warning, 4 info - added the new `19+` enum value to the `allOf[subschema #2]/items/items/allOf[#/components/schemas/AdGroupCommon]/targeting_spec/AGE_BUCKET/items/` response property for the response status `200` - added the new `20+` enum value to the `allOf[subschema #2]/items/items/allOf[#/components/schemas/AdGroupCommon]/targeting_spec/AGE_BUCKET/items/` response property for the response status `200` - the endpoint scheme security `client_credentials` was added to the API - added the optional property `allOf[subschema #2]/items/items/allOf[#/components/schemas/AdGroupCommon]/is_creative_optimization` to the response with the `200` status - added the optional property `allOf[subschema #2]/items/items/allOf[#/components/schemas/AdGroupCommon]/promotion_id` to the response with the `200` status - added the optional property `allOf[subschema #2]/items/items/allOf[subschema #2]/bid_multiplier` to the response with the `200` status - **2024-04-23** (v5) `f9321315766f`: 1 breaking, 1 warning, 2 info - the `allOf[subschema #2]/` response's property type changed from no type to `object` for status `200` - removed the optional property `allOf[subschema #2]/items/items/allOf[#/components/schemas/AdGroupCommon]/targeting_spec/AUDIENCE_INCLUDE'` from the response with the `200` status - added the optional property `allOf[subschema #2]/items/items/allOf[#/components/schemas/AdGroupCommon]/targeting_spec/AUDIENCE_INCLUDE` to the response with the `200` status - added the optional property `allOf[subschema #2]/items/items/allOf[#/components/schemas/AdGroupCommon]/targeting_template_ids` to the response with the `200` status - **2024-02-08** (v5) `7529b464d5cb`: 4 warning, 3 info - added the new `DELETED_DRAFT` enum value to the `allOf[subschema #2]/items/items/allOf[#/components/schemas/AdGroupCommon]/status/allOf[#/components/schemas/EntityStatus]/` response property for the response status `200` - added the new `DELETED_DRAFT` enum value to the `allOf[subschema #2]/items/items/allOf[subschema #2]/summary_status/allOf[#/components/schemas/AdGroupSummaryStatus]/` response property for the response status `200` - added the new `DRAFT` enum value to the `allOf[subschema #2]/items/items/allOf[#/components/schemas/AdGroupCommon]/status/allOf[#/components/schemas/EntityStatus]/` response property for the response status `200` - added the new `DRAFT` enum value to the `allOf[subschema #2]/items/items/allOf[subschema #2]/summary_status/allOf[#/components/schemas/AdGroupSummaryStatus]/` response property for the response status `200` - added the enum value `DELETED_DRAFT` to the property `items/` of the `query` request parameter `entity_statuses` - added the enum value `DRAFT` to the property `items/` of the `query` request parameter `entity_statuses` - the `` response's property default value `ALL` was added for the status `200` - **2023-08-17** (v5) `0ff12596bafd`: 1 warning - added the new `TWENTY_FOUR_HOUR` enum value to the `allOf[subschema #2]/items/items/allOf[#/components/schemas/AdGroupCommon]/optimization_goal_metadata/allOf[#/components/schemas/OptimizationGoalMetadata]/frequency_goal_metadata/timerange` response property for the response status `200` - **2023-05-12** (v5) `689b4b267639`: 16 info - added the optional property `allOf[subschema #2]/items/items/allOf[#/components/schemas/AdGroupCommon]/targeting_spec/AGE_BUCKET` to the response with the `200` status - added the optional property `allOf[subschema #2]/items/items/allOf[#/components/schemas/AdGroupCommon]/targeting_spec/APPTYPE` to the response with the `200` status - added the optional property `allOf[subschema #2]/items/items/allOf[#/components/schemas/AdGroupCommon]/targeting_spec/AUDIENCE_EXCLUDE` to the response with the `200` status - added the optional property `allOf[subschema #2]/items/items/allOf[#/components/schemas/AdGroupCommon]/targeting_spec/AUDIENCE_INCLUDE'` to the response with the `200` status - added the optional property `allOf[subschema #2]/items/items/allOf[#/components/schemas/AdGroupCommon]/targeting_spec/GENDER` to the response with the `200` status - added the optional property `allOf[subschema #2]/items/items/allOf[#/components/schemas/AdGroupCommon]/targeting_spec/GEO` to the response with the `200` status - added the optional property `allOf[subschema #2]/items/items/allOf[#/components/schemas/AdGroupCommon]/targeting_spec/INTEREST` to the response with the `200` status - added the optional property `allOf[subschema #2]/items/items/allOf[#/components/schemas/AdGroupCommon]/targeting_spec/LOCALE` to the response with the `200` status - added the optional property `allOf[subschema #2]/items/items/allOf[#/components/schemas/AdGroupCommon]/targeting_spec/LOCATION` to the response with the `200` status - added the optional property `allOf[subschema #2]/items/items/allOf[#/components/schemas/AdGroupCommon]/targeting_spec/SHOPPING_RETARGETING` to the response with the `200` status - added the optional property `allOf[subschema #2]/items/items/allOf[#/components/schemas/AdGroupCommon]/targeting_spec/TARGETING_STRATEGY` to the response with the `200` status - added `#/components/schemas/BudgetType` to the `allOf[subschema #2]/items/items/allOf[#/components/schemas/AdGroupCommon]/budget_type` response property `allOf` list for the response status `200` - removed the `BILLABLE_ENGAGEMENT` enum value from the `allOf[subschema #2]/items/items/allOf[#/components/schemas/AdGroupCommon]/billable_event` response property for the response status `200` - removed the `CBO_ADGROUP` enum value from the `allOf[subschema #2]/items/items/allOf[#/components/schemas/AdGroupCommon]/budget_type` response property for the response status `200` - removed the `DAILY` enum value from the `allOf[subschema #2]/items/items/allOf[#/components/schemas/AdGroupCommon]/budget_type` response property for the response status `200` - removed the `LIFETIME` enum value from the `allOf[subschema #2]/items/items/allOf[#/components/schemas/AdGroupCommon]/budget_type` response property for the response status `200` - **2023-02-14** (v5) `be19b77aa78a`: 7 breaking, 1 warning, 1 info - for the `query` request parameter `entity_statuses`, default value `ACTIVE, PAUSED` was added - the response property `allOf[subschema #2]/items/items/allOf[#/components/schemas/AdGroupCommon]/bid_strategy_type` became nullable for the status `200` - the `allOf[subschema #2]/items/items/allOf[#/components/schemas/AdGroupCommon]/tracking_urls/allOf[#/components/schemas/TrackingUrls]/audience_verification/items/` response property's maxLength was unset from `2000` for the response status `200` - the `allOf[subschema #2]/items/items/allOf[#/components/schemas/AdGroupCommon]/tracking_urls/allOf[#/components/schemas/TrackingUrls]/buyable_button/items/` response property's maxLength was unset from `2000` for the response status `200` - the `allOf[subschema #2]/items/items/allOf[#/components/schemas/AdGroupCommon]/tracking_urls/allOf[#/components/schemas/TrackingUrls]/click/items/` response property's maxLength was unset from `2000` for the response status `200` - the `allOf[subschema #2]/items/items/allOf[#/components/schemas/AdGroupCommon]/tracking_urls/allOf[#/components/schemas/TrackingUrls]/engagement/items/` response property's maxLength was unset from `2000` for the response status `200` - the `allOf[subschema #2]/items/items/allOf[#/components/schemas/AdGroupCommon]/tracking_urls/allOf[#/components/schemas/TrackingUrls]/impression/items/` response property's maxLength was unset from `2000` for the response status `200` - added the new `undefined` enum value to the `allOf[subschema #2]/items/items/allOf[#/components/schemas/AdGroupCommon]/bid_strategy_type` response property for the response status `200` - added the optional property `allOf[subschema #2]/items/items/allOf[#/components/schemas/AdGroupCommon]/optimization_goal_metadata` to the response with the `200` status - **2022-11-14** (v5) `e041d7b0cef0`: 1 breaking, 1 info - for the `path` request parameter `ad_account_id`, the maxLength was decreased from `19` to `18` - for the `query` request parameter `page_size`, the max was increased from `100.00` to `250.00` - **2022-09-07** (v5) `bd20b6eb152f`: 1 warning, 1 info - for the `path` request parameter `ad_account_id`, the maxLength was set to `19` - the `allOf[subschema #2]/items/items/allOf[#/components/schemas/AdGroupCommon]/campaign_id` response's property pattern was changed from `^\d+$` to `^[C]?\d+$` for the status `200` - **2022-07-11** (v5) `0d5998752011`: 1 breaking, 4 info - the `allOf[subschema #2]/items/items/` response's property type changed from no type to `object` for status `200` - api tag `ad_groups` added - api tag `ad_accounts` removed - added `#/components/schemas/AdGroupCommon, subschema #2` to the `allOf[subschema #2]/items/items/` response property `allOf` list for the response status `200` - removed `subschema #1, subschema #2` from the `allOf[subschema #2]/items/items/` response property `allOf` list for the response status `200` - **2021-12-16** (v5) `2a34d1d22a47`: 1 warning - changed the pattern of the `path` request parameter `ad_account_id` from `\d+` to `^\d+$` - **2021-11-05** (v5) `8583f6373a80`: 5 breaking, 1 info - the `allOf[subschema #2]/items/items/allOf[subschema #1]/pacing_delivery_type` response's property type changed from no type to `string` for status `200` - the `allOf[subschema #2]/items/items/allOf[subschema #1]/placement_group` response's property type changed from no type to `string` for status `200` - the `allOf[subschema #2]/items/items/allOf[subschema #1]/status` response's property type changed from no type to `string` for status `200` - the `allOf[subschema #2]/items/items/allOf[subschema #1]/summary_status` response's property type changed from no type to `string` for status `200` - the `allOf[subschema #2]/items/items/allOf[subschema #1]/tracking_urls` response's property type changed from no type to `object` for status `200` - added the non-success response with the status `400` --- [Operation](https://skmtc.dev/pinterest/apis/pinterest-rest-api/docs/ad_accounts/:ad_account_id/ad_groups/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/ad_groups/get)