---
title: "Changes to List Ads"
method: GET
path: "/ads"
---

# Changes to List Ads

`GET /ads`

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

## Timeline

Changed in 13 of 74 revisions.

- **2026-09-25** `86b97292852d` — 3 breaking, 8 info
- **2026-09-24** `7fcefabddb0a` — 1 warning, 3 info
- **2026-09-23** `140d015b9966` — 1 warning
- **2026-09-21** `ac2b9b1c6a00` — 1 info
- **2026-09-02** `9b2baa68698c` — 1 info
- **2026-08-27** `16c82685be35` — 2 info
- **2026-08-25** `621705ee8f4a` — 1 info
- **2026-08-20** `4a1a4a5d2c72` — 1 warning
- **2026-08-15** `c301132dbfd7` — 1 warning
- **2026-08-07** `f1020c3ecda4` — 2 info
- **2026-07-31** `099fdc3be422` — 2 info
- **2026-07-26** `60bbb4a6ffbc` — 8 breaking, 11 info
- **2026-07-14** `3a06a605784b` — 2 info

## Changes

- **2026-09-25** `86b97292852d` — 3 breaking, 8 info
  - the `data/items/descriptions/items/` response's property type changed from `string` to `object` for status `200`
  - the `data/items/headlines/items/` response's property type changed from `string` to `object` for status `200`
  - the `data/items/primary_texts/items/` response's property type changed from `string` to `object` for status `200`
  - added the optional property `data/items/translations` to the response with the `200` status
  - added the required property `data/items/creatives/items/language` to the response with the `200` status
  - added the required property `data/items/descriptions/items/language` to the response with the `200` status
  - added the required property `data/items/descriptions/items/text` to the response with the `200` status
  - added the required property `data/items/headlines/items/language` to the response with the `200` status
  - added the required property `data/items/headlines/items/text` to the response with the `200` status
  - added the required property `data/items/primary_texts/items/language` to the response with the `200` status
  - added the required property `data/items/primary_texts/items/text` to the response with the `200` status
- **2026-09-24** `7fcefabddb0a` — 1 warning, 3 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/lead_form/oneOf[#/components/schemas/AdLeadForm]/completion/oneOf[#/components/schemas/AdLeadFormCompletion]/button_type` to the response with the `200` status
  - added the required property `data/items/lead_form/oneOf[#/components/schemas/AdLeadForm]/completion/oneOf[#/components/schemas/AdLeadFormCompletion]/file_url` to the response with the `200` status
  - added the required property `data/items/lead_form/oneOf[#/components/schemas/AdLeadForm]/completion/oneOf[#/components/schemas/AdLeadFormCompletion]/phone_number` 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` — 1 info
  - added the required property `data/items/platform` to the response with the `200` status
- **2026-09-02** `9b2baa68698c` — 1 info
  - added the optional property `data/items/music` to the response with the `200` status
- **2026-08-27** `16c82685be35` — 2 info
  - added the new enum value `link_clicks` to the `query` request parameter `order`
  - added the required property `data/items/link_clicks` to the response with the `200` status
- **2026-08-25** `621705ee8f4a` — 1 info
  - added the required property `data/items/existing_post_id` to the response with the `200` status
- **2026-08-20** `4a1a4a5d2c72` — 1 warning
  - added the new `scheduled` enum value to the `data/items/delivery_status` response property for the response 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-07** `f1020c3ecda4` — 2 info
  - added the optional property `error/code` to the response with the `400` status
  - added the optional property `error/code` to the response with the `401` status
- **2026-07-31** `099fdc3be422` — 2 info
  - added the new optional `query` request parameter `ad_campaign_ids`
  - added the new optional `query` request parameter `ad_group_ids`
- **2026-07-26** `60bbb4a6ffbc` — 8 breaking, 11 info
  - the response property `data/items/lead_form` became optional for the status `200`
  - the response property `data/items/lead_form_id` became optional for the status `200`
  - the response property `data/items/messaging_config` became optional for the status `200`
  - the response property `data/items/multi_advertiser_ads` became optional for the status `200`
  - added `#/components/schemas/AdLeadForm, subschema #2` to the `data/items/lead_form` response property `oneOf` list for the response status `200`
  - added `#/components/schemas/AdMessagingConfig, subschema #2` to the `data/items/messaging_config` response property `oneOf` list for the response status `200`
  - the `data/items/lead_form` response's property type changed from `object, null` to no type for status `200`
  - the `data/items/messaging_config` response's property type changed from `object, null` to no type for status `200`
  - added the new optional `query` request parameter `attribution_model`
  - added the required property `data/items/added_to_cart_value` to the response with the `200` status
  - added the required property `data/items/completed_registration_value` to the response with the `200` status
  - added the required property `data/items/contact_value` to the response with the `200` status
  - added the required property `data/items/cost_per_unique_click` to the response with the `200` status
  - added the required property `data/items/custom_event_values` to the response with the `200` status
  - added the required property `data/items/lead_value` to the response with the `200` status
  - added the required property `data/items/schedule_value` to the response with the `200` status
  - added the required property `data/items/social_accounts/items/id` to the response with the `200` status
  - added the required property `data/items/submitted_application_value` to the response with the `200` status
  - added the required property `data/items/viewed_content_value` to the response with the `200` status
- **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/ads/get.md) · [API](https://skmtc.dev/whop/apis/whop-api.md) · [Page](https://skmtc.dev/whop/apis/whop-api/changes/ads/get)
