---
title: "List all ads"
method: GET
path: "/Advertisers/{AccountSID}/Ads"
tags: ["Ads"]
---

# List all ads

`GET /Advertisers/{AccountSID}/Ads`

Returns an array of ad objects, ordered by creation date (newest first).

## Path parameters

- `AccountSID` string, required

## Query parameters

- `CampaignId` string
- `Type` 'BANNER' | 'TEXT_LINK' | 'COUPON'
- `DealId` string
- `MobileReady` boolean

## Response `200`

A list of ads.

- object
  - `@page` string
  - `Ads` Ad[]
    - `Id` string
    - `Name` string
    - `Description` string
    - `CampaignId` string
    - `CampaignName` string
    - `AdType` 'BANNER' | 'TEXT_LINK' | 'COUPON'
    - `LandingPage` string
    - `MobileFallbacks` object
      - `ANDROID` string
      - `IOS` string
    - `CustomAdServingUrl` string
    - `IabAdUnit` string
    - `ThirdPartyServableAdCreativeHeight` string
    - `ThirdPartyServableAdCreativeWidth` string
    - `BannerAlternativeTag` string
    - `LinkText` string
    - `CouponLinkName` string
    - `GetHtmlCodeType` string
    - `Labels` string
    - `AllowDeepLinking` string
    - `Language` string — The language of the ad creative. Possible values: `AFRIKAANS`, `ARABIC`, `BULGARIAN`, `CHINESE`, `CHINESE_TRADITIONAL`, `CZECH`, `DANISH`, `DUTCH`, `ENGLISH`, `ENGLISH_GB`, `ENGLISH_AU`, `ENGLISH_CA`, `ENGLISH_NZ`, `ENGLISH_ZA`, `ESTONIAN`, `FILIPINO`, `FINNISH`, `FRENCH`, `FRENCH_CA`, `GERMAN`, `HEBREW`, `HINDI`, `INDONESIAN`, `ITALIAN`, `JAPANESE`, `KOREAN`, `LATVIAN`, `LITHUANIAN`, `MALAY`, `MALTESE`, `NORWEGIAN`, `PORTUGUESE`, `PORTUGUESE_BR`, `POLISH`, `RUSSIAN`, `SLOVENIAN`, `SPANISH`, `SPANISH_MX`, `SWEDISH`, `THAI`, `TURKISH`, `VIETNAMESE`.
    - `LimitedTimeStartDate` string, date-time
    - `LimitedTimeEndDate` string, date-time
    - `Season` string — If the ad has a seasonal promotional theme, this is the season the ad targets. Possible values: `ANZAC_DAY`, `AUGUST_CIVIC_HOLIDAY`, `AUSTRALIA_DAY`, `BACK_TO_SCHOOL`, `BLACK_FRIDAY`, `BOXING_DAY`, `CANADA_DAY`, `CYBER_MONDAY`, `END_OF_FINANCIAL_YEAR`, `FAMILY_DAY`, `FATHERS_DAY`, `GOOD_FRIDAY`, `HALLOWEEN`, `HANUKKAH`, `INDEPENDANCE_DAY`, `LABOR_DAY`, `MEMORIAL_DAY`, `MOTHERS_DAY`, `NEW_YEAR`, `PRESIDENTS_DAY`, `QUEENS_BIRTHDAY`, `REMEMBRANCE_DAY`, `SPRING`, `ST_PATRICKS_DAY`, `SUMMER`, `THANKSGIVING`, `VALENTINES_DAY`, `VICTORIA_DAY`, `WAITANGI_DAY`, `WINTER`, `OTHER`.
    - `DealId` string
    - `DealName` string
    - `DateCreated` string, date-time
    - `DateLastUpdated` string, date-time
    - `AdCodeTemplate` string
    - `CouponAllowCustomPromoCode` string
    - `CustomisationCharge` string
    - `MobileReady` string
    - `PhoneTracking` string
    - `PromoCodeTracking` string
    - `TopSeller` string
    - `RestrictedMediaPartners` string[]
    - `RestrictedMediaPartnerGroups` string[]
    - `DealDescription` string
    - `DealState` string
    - `DealType` string
    - `DealScope` string
    - `DealProducts` string[]
    - `DealCategories` string
    - `DiscountType` string
    - `DiscountAmount` string
    - `DiscountCurrency` string
    - `DiscountPercent` string
    - `DiscountMaximumPercent` string
    - `DiscountPercentRangeStart` string
    - `DiscountPercentRangeEnd` string
    - `Gift` string
    - `RebateAmount` string
    - `RebateCurrency` string
    - `DealDefaultPromoCode` string
    - `MinimumPurchaseAmount` string
    - `MinimumPurchaseAmountCurrency` string
    - `MaximumSavingsAmount` string
    - `MaximumSavingsCurrency` string
    - `BogoBuyQuantity` string
    - `BogoBuyScope` string
    - `BogoBuyName` string
    - `BogoBuyImageUrl` string
    - `BogoGetQuantity` string
    - `BogoGetScope` string
    - `BogoGetDiscountType` string
    - `BogoGetName` string
    - `BogoGetImageUrl` string
    - `BogoGetDiscountAmount` string
    - `BogoGetDiscountCurrency` string
    - `BogoGetDiscountPercent` string
    - `PurchaseLimitQuantity` string
    - `DealStartDate` string, date-time
    - `DealEndDate` string, date-time
    - `SynchAdsPromoCodes` string
    - `DealRestrictedMediaPartners` string[]
    - `DealRestrictedMediaPartnerGroups` string[]
    - `Uri` string, uri-reference

---

[API](https://skmtc.net/impact/apis/brand-api-account-information.md) · [All operations](https://skmtc.net/impact/apis/brand-api-account-information/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/impact/brand-api-account-information/revisions/c53422ebb833/schema)