ad_accounts14

ad_groups13

ads10

advanced_auction2

audience_insights2

audience_sharing7

audiences4

billing11

boards11

bulk3

business_access_assets12

business_access_invite6

business_access_relationships9

campaigns8

catalog_feeds8

catalog_items3

catalog_product_groups10

catalog_reports3

catalog_supplemental7

catalogs3

conversion_deletion_requests4

conversion_eqs1

conversion_events1

conversion_tags5

conversions4

customer_list_uploads3

customer_lists4

customer_segment3

integrations7

keywords5

labels5

lead_ads4

lead_forms5

leads_export2

media3

msot_events1

notification1

oauth3

order_lines2

pins8

product_group_promotions5

product_tags3

promotions5

resources6

schedules3

search3

targeting_template3

terms2

terms_of_service1

trends4

user_account14

ads

Changes to List ads

get/ad_accounts/{ad_account_id}/ads

Jun 4, 2026v5b698c180678a Revision changes
- breaking
  for the query request parameter order, default value ASCENDING was added
- breaking
  the response's body type changed from no type to object for status
- info
  removed subschema #2 from the response body allOf list for the response status
- info
  added the non-success response with the status
- info
  added the non-success response with the status
- info
  added the non-success response with the status
- info
  added the non-success response with the status
- info
  added the optional property to the response with the status
- info
  added the required property to the response with the status
Dec 11, 2025v5537bde5a50b1 Revision changes
- info
  added the optional property /////// to the response with the status
- info
  added the optional property /////// to the response with the status
Oct 16, 2025v514c297539b64 Revision changes
- warning
  added the new COLLAGE enum value to the /////// response property for the response status
- warning
  added the new MAX_WIDTH_REGULAR_COLLECTION enum value to the /////// response property for the response status
- warning
  added the new MAX_WIDTH_VIDEO_COLLECTION enum value to the /////// response property for the response status
- info
  for the query request parameter ad_group_ids, the maxItems was increased from 100 to 250
- info
  for the query request parameter ad_ids, the maxItems was increased from 100 to 250
- info
  for the query request parameter campaign_ids, the maxItems was increased from 100 to 250
Apr 4, 2025v510f9eba4ad97 Revision changes
- warning
  added the new BUY_TICKETS enum value to the /////// response property for the response status
- warning
  added the new DONATE_NOW enum value to the /////// response property for the response status
- warning
  added the new DOWNLOAD enum value to the /////// response property for the response status
- warning
  added the new EXPLORE_MORE enum value to the /////// response property for the response status
- warning
  added the new FIND_A_LOCATION enum value to the /////// response property for the response status
- warning
  added the new GET_DEAL enum value to the /////// response property for the response status
- warning
  added the new GET_RECIPE enum value to the /////// response property for the response status
- warning
  added the new GET_SHOWTIMES enum value to the /////// response property for the response status
- warning
  added the new ON_SALE enum value to the /////// response property for the response status
- warning
  added the new PLAY_GAME enum value to the /////// response property for the response status
- warning
  added the new TRY_IT enum value to the /////// response property for the response status
- info
  the endpoint scheme security client_credentials was added to the API
Aug 14, 2024v589c27ed39cfd Revision changes
- warning
  added the new VISIT_SITE enum value to the /////// response property for the response status
- info
  added the optional property //////////// to the response with the status
- info
  added the optional property //////////// to the response with the status
- info
  removed the VISIT_WEBSITE enum value from the /////// response property for the response status
Apr 23, 2024v5f9321315766f Revision changes
- breaking
  the response's property type changed from no type to object for status
Feb 8, 2024v57529b464d5cb Revision changes
- warning
  added the new DELETED_DRAFT enum value to the /////// response property for the response status
- warning
  added the new DELETED_DRAFT enum value to the //////// response property for the response status
- warning
  added the new DRAFT enum value to the /////// response property for the response status
- warning
  added the new DRAFT enum value to the //////// response property for the response status
- info
  added the enum value DELETED_DRAFT to the property items/ of the query request parameter entity_statuses
- info
  added the enum value DRAFT to the property items/ of the query request parameter entity_statuses
- info
  added the optional property /////// to the response with the status
- info
  added the optional property /////// to the response with the status
- info
  added the optional property /////// to the response with the status
Aug 17, 2023v50ff12596bafd Revision changes
- info
  added the optional property /////// to the response with the status
Jul 14, 2023v552586a274771 Revision changes
- warning
  added the new COLLECTION enum value to the /////// response property for the response status
- warning
  added the new SHOWCASE enum value to the /////// response property for the response status
May 12, 2023v5689b4b267639 Revision changes
- warning
  added the new QUIZ enum value to the /////// response property for the response status
Feb 14, 2023v5be19b77aa78a Revision changes
- breaking
  for the query request parameter entity_statuses, default value ACTIVE PAUSED was added
- breaking
  the ///////////// response property's maxLength was unset from 2000 for the response status
- breaking
  the ///////////// response property's maxLength was unset from 2000 for the response status
- breaking
  the ///////////// response property's maxLength was unset from 2000 for the response status
- breaking
  the ///////////// response property's maxLength was unset from 2000 for the response status
- breaking
  the ///////////// response property's maxLength was unset from 2000 for the response status
- warning
  removed the optional property /////// from the response with the status
- info
  added to the // response property allOf list for the response status
Nov 14, 2022v5e041d7b0cef0 Revision changes
- breaking
  for the path request parameter ad_account_id, the maxLength was decreased from 19 to 18
- info
  for the query request parameter page_size, the max was increased from 100.00 to 250.00
Sep 7, 2022v5bd20b6eb152f Revision changes
- warning
  for the path request parameter ad_account_id, the maxLength was set to 19
- warning
  added the new IDEA enum value to the /////// response property for the response status
- info
  removed the STORY enum value from the /////// response property for the response status
- info
  the /////// response's property pattern was changed from ^\d+$ to ^(AG)?\d+$ for the status
Jul 11, 2022v50d5998752011 Revision changes
- breaking
  the // response's property type changed from no type to object for status
- info
  api tag ads added
- info
  api tag ad_accounts removed
Dec 16, 2021v52a34d1d22a47 Revision changes
- warning
  changed the pattern of the path request parameter ad_account_id from \d+ to ^\d+$
Nov 5, 2021v58583f6373a80 Revision changes
- info
  added the non-success response with the status
- info
  added subschema #1 subschema #2 to the // response property allOf list for the response status
- info
  removed subschema #1 subschema #2 from the // response property allOf list for the response status