---
title: "Changes to List Ad Groups"
method: GET
path: "/ad_groups"
---

# Changes to List Ad Groups

`GET /ad_groups`

> Every recorded change to this endpoint, newest first.
> 74 revisions in range; 1 not diffed.

## Timeline

Changed in 10 of 74 revisions.

- **2026-09-24** `7fcefabddb0a` — 1 warning, 2 info
- **2026-09-23** `140d015b9966` — 1 warning
- **2026-09-21** `ac2b9b1c6a00` — 3 info
- **2026-08-27** `16c82685be35` — 3 info
- **2026-08-20** `6a23760847c8` — 8 info
- **2026-08-15** `c301132dbfd7` — 1 warning
- **2026-08-12** `ae20b30817de` — 4 warning
- **2026-07-31** `099fdc3be422` — 6 warning, 1 info
- **2026-07-26** `60bbb4a6ffbc` — 13 breaking, 25 warning, 27 info
- **2026-07-14** `3a06a605784b` — 2 info

## Changes

- **2026-09-24** `7fcefabddb0a` — 1 warning, 2 info
  - added the new `google` enum value to the `data/items/platform` response property for the response status `200`
  - added the required property `data/items/budget_amount_local` to the response with the `200` status
  - added the required property `data/items/budget_currency` to the response with the `200` status
- **2026-09-23** `140d015b9966` — 1 warning
  - added the new `in_appeal` enum value to the `data/items/delivery_status` response property for the response status `200`
- **2026-09-21** `ac2b9b1c6a00` — 3 info
  - added the optional property `data/items/regions/exclude/custom_locations/items/country_code` to the response with the `200` status
  - added the optional property `data/items/regions/include/custom_locations/items/country_code` to the response with the `200` status
  - added the required property `data/items/platform` to the response with the `200` status
- **2026-08-27** `16c82685be35` — 3 info
  - added the new enum value `link_clicks` to the `query` request parameter `order`
  - the response property `data/items/conversion_event` became required for the status `200`
  - added the required property `data/items/link_clicks` to the response with the `200` status
- **2026-08-20** `6a23760847c8` — 8 info
  - added the optional property `data/items/detailed_targeting/behaviors/items/behavior_type` to the response with the `200` status
  - added the optional property `data/items/detailed_targeting/behaviors/items/period` to the response with the `200` status
  - the response property `data/items/detailed_targeting` became required for the status `200`
  - the response property `data/items/devices` became required for the status `200`
  - the response property `data/items/frequency_cap` became required for the status `200`
  - the response property `data/items/languages` became required for the status `200`
  - the response property `data/items/placements` became required for the status `200`
  - the response property `data/items/regions` became required for the status `200`
- **2026-08-15** `c301132dbfd7` — 1 warning
  - added the new `messaging_conversation` enum value to the `data/items/result_event` response property for the response status `200`
- **2026-08-12** `ae20b30817de` — 4 warning
  - added the new `education_majors` enum value to the `data/items/detailed_targeting/demographics/items/type` response property for the response status `200`
  - added the new `education_schools` enum value to the `data/items/detailed_targeting/demographics/items/type` response property for the response status `200`
  - added the new `work_employers` enum value to the `data/items/detailed_targeting/demographics/items/type` response property for the response status `200`
  - added the new `work_positions` enum value to the `data/items/detailed_targeting/demographics/items/type` response property for the response status `200`
- **2026-07-31** `099fdc3be422` — 6 warning, 1 info
  - added the new `audience_network` enum value to the `data/items/placements/items/platform` response property for the response status `200`
  - added the new `facebook` enum value to the `data/items/placements/items/platform` response property for the response status `200`
  - added the new `instagram` enum value to the `data/items/placements/items/platform` response property for the response status `200`
  - added the new `messenger` enum value to the `data/items/placements/items/platform` response property for the response status `200`
  - added the new `threads` enum value to the `data/items/placements/items/platform` response property for the response status `200`
  - added the new `whatsapp` enum value to the `data/items/placements/items/platform` response property for the response status `200`
  - added the new optional `query` request parameter `ad_campaign_ids`
- **2026-07-26** `60bbb4a6ffbc` — 13 breaking, 25 warning, 27 info
  - the `query` request parameter `status` was restricted to a list of enum values
  - the response property `data/items/conversion_event` became optional for the status `200`
  - the response property `data/items/conversion_location` became optional for the status `200`
  - the response property `data/items/devices` became optional for the status `200`
  - the response property `data/items/dynamic_creative` became optional for the status `200`
  - the response property `data/items/frequency_cap` became optional for the status `200`
  - the response property `data/items/languages` became optional for the status `200`
  - the response property `data/items/message_apps` became optional for the status `200`
  - the response property `data/items/minimum_daily_spend` became optional for the status `200`
  - the response property `data/items/placements` became optional for the status `200`
  - the response property `data/items/regions` became optional for the status `200`
  - added `#/components/schemas/AdGroupFrequencyCap, subschema #2` to the `data/items/frequency_cap` response property `oneOf` list for the response status `200`
  - the `data/items/frequency_cap` response's property type changed from `object, null` to no type for status `200`
  - added the new `ad_recall_lift` enum value to the `data/items/optimization_goal` response property for the response status `200`
  - added the new `conversations` enum value to the `data/items/optimization_goal` response property for the response status `200`
  - added the new `conversions` enum value to the `data/items/optimization_goal` response property for the response status `200`
  - added the new `duplicating` enum value to the `data/items/status` response property for the response status `200`
  - added the new `engagement` enum value to the `data/items/optimization_goal` response property for the response status `200`
  - added the new `event_responses` enum value to the `data/items/optimization_goal` response property for the response status `200`
  - added the new `impressions` enum value to the `data/items/optimization_goal` response property for the response status `200`
  - added the new `instagram` enum value to the `data/items/message_apps/items/` response property for the response status `200`
  - added the new `instagram_and_facebook` enum value to the `data/items/conversion_location` response property for the response status `200`
  - added the new `instagram_profile` enum value to the `data/items/conversion_location` response property for the response status `200`
  - added the new `landing_page_views` enum value to the `data/items/optimization_goal` response property for the response status `200`
  - added the new `lead_generation` enum value to the `data/items/optimization_goal` response property for the response status `200`
  - added the new `link_clicks` enum value to the `data/items/optimization_goal` response property for the response status `200`
  - added the new `messenger` enum value to the `data/items/message_apps/items/` response property for the response status `200`
  - added the new `page_likes` enum value to the `data/items/optimization_goal` response property for the response status `200`
  - added the new `profile_and_page_engagement` enum value to the `data/items/optimization_goal` response property for the response status `200`
  - added the new `quality_lead` enum value to the `data/items/optimization_goal` response property for the response status `200`
  - added the new `reach` enum value to the `data/items/optimization_goal` response property for the response status `200`
  - added the new `reminders_set` enum value to the `data/items/optimization_goal` response property for the response status `200`
  - added the new `social_profile` enum value to the `data/items/optimization_goal` response property for the response status `200`
  - added the new `two_second_views` enum value to the `data/items/optimization_goal` response property for the response status `200`
  - added the new `undefined` enum value to the `data/items/optimization_goal` response property for the response status `200`
  - added the new `value` enum value to the `data/items/optimization_goal` response property for the response status `200`
  - added the new `video_views` enum value to the `data/items/optimization_goal` response property for the response status `200`
  - added the new `whatsapp` enum value to the `data/items/message_apps/items/` response property for the response status `200`
  - added the new optional `query` request parameter `attribution_model`
  - added the new enum value `active` to the `query` request parameter `status`
  - …25 more
- **2026-07-14** `3a06a605784b` — 2 info
  - added the required property `data/items/custom_event_counts` to the response with the `200` status
  - added the required property `data/items/results` to the response with the `200` status

---

[Operation](https://skmtc.dev/whop/apis/whop-api/docs/ad_groups/get.md) · [API](https://skmtc.dev/whop/apis/whop-api.md) · [Page](https://skmtc.dev/whop/apis/whop-api/changes/ad_groups/get)
