Ads API •References / ads / Get Ads by Ad Account ID

Get Ads by Ad Account ID

Returns a list of ads for the given ad account.

Request

ad_account_idstring [uuid]
Required
A unique identifier for an Ad Account.
Example: ce4ff15e-f04d-48b9-9ddf-fb3c85fbd57a
fieldsarray of strings
Unique items
Subset of ad fields to be returned.
Array minimum length: 1Example: fields=NAME&fields=CREATED_AT&fields=STATUS
Allowed values: "AD_ACCOUNT_ID", "ADVERTISER_NAME", "AD_PREVIEW_URL", "AD_SET_ID", "ASSETS", "CAMPAIGN_ID", "CALL_TO_ACTION", "CREATED_AT", "DELIVERY", "END_TIME", "ID", "NAME", "REJECT_REASON", "REJECT_REASONS", "START_TIME", "STATUS", "TAGLINE", "THIRD_PARTY_TRACKING", "UPDATED_AT", "DV_CLIENT_CODE", "WEIGHT"
ad_set_idsarray of strings
A list of Ad Set IDs to fetch Ads for only the given subset of Ad Sets
A unique identifier for the entity.
Example: ad_set_ids=ce4ff15e-f04d-48b9-9ddf-fb3c85fbd57a
asset_idsarray of strings
A list of Asset IDs to fetch Ads for only the given subset of Assets
A unique identifier for the entity.
Example: asset_ids=ce4ff15e-f04d-48b9-9ddf-fb3c85fbd57a
namestring
The string that will be used to filter Ad by name. The filter is case-insensitive and will match any Ad that contains the given string in its name.
statusesarray of strings
Unique items
The set of enums that will be used to filter Ad by statuses. The filter will match any Ad that has one of the given statuses.
Status of the ad.
Allowed values: "ACTIVE", "APPROVED", "ARCHIVED", "PENDING", "PENDING_APPROVAL", "REJECTED", "UNRECOGNIZED"Example: statuses=PENDING
limitinteger
Limit or page size for a given response.
Default: limit=50Range: 1 - 50Example: limit=50
offsetinteger
Starting position of the next record to assist in data pagination.
Default: offset=0Example: offset=0
sort_directionstring
Field by which to order the results of the query.
Default: sort_direction=DESCAllowed values: "ASC", "DESC"Example: sort_direction=ASC
sort_fieldstring
Field by which to sort list of ads.
Default: sort_field=CREATED_ATAllowed values: "CREATED_AT", "ID", "NAME", "STATUS", "UPDATED_AT"Example: sort_field=STATUS

Response

A list of ads.

- page_sizeinteger [int32]
- total_resultsinteger [int32]
- offsetinteger [int32]
- current_pageinteger [int32]
- idstring [uuid]
  A unique identifier for the entity.
  Example: "ce4ff15e-f04d-48b9-9ddf-fb3c85fbd57a"
- The metadata for the behavior of the call-to-action button.
  keystring
  The identifier used for the call-to-action button. This will be translated using the locale.
  Example: "LEARN_MORE"
  textstring
  The post-translation text used for the call-to-action-button-text
  Example: "Learn more"
  languagestring
  clickthrough_urlstring
  Required
  The link to the ads desired landing page.
  Example: "https://www.spotify.com"
- created_atstring [date-time]
  Date the entity was created. Time should be in ISO 8601 format using Coordinated Universal Time (UTC) with a zero offset: YYYY-MM-DDTHH:MM:SSZ
  Example: "2026-01-23T04:56:07Z"
- updated_atstring [date-time]
  Date the entity was updated. Time should be in ISO 8601 format using Coordinated Universal Time (UTC) with a zero offset: YYYY-MM-DDTHH:MM:SSZ
  Example: "2026-01-23T04:56:07Z"
- start_timestring [date-time]
  Time should be in ISO 8601 format using Coordinated Universal Time (UTC) with a zero offset: YYYY-MM-DDTHH:MM:SSZ
  Example: "2023-09-23T04:56:07Z"
- end_timestring [date-time]
  Time should be in ISO 8601 format using Coordinated Universal Time (UTC) with a zero offset: YYYY-MM-DDTHH:MM:SSZ
  Example: "2023-09-23T04:56:07Z"
- deliverystring
  Toggles the delivery of the entity ON or OFF.
  Allowed values: "ON", "OFF"Example: "ON"
- ad_set_idstring [uuid]
  A unique identifier for the entity.
  Example: "ce4ff15e-f04d-48b9-9ddf-fb3c85fbd57a"
- statusstring
  Status of the ad.
  Allowed values: "ACTIVE", "APPROVED", "ARCHIVED", "PENDING", "PENDING_APPROVAL", "REJECTED", "UNRECOGNIZED"Example: "PENDING"
- reject_reasonstring
  Reason the ad has been put into the REJECTED state (if applicable).
  Example: "Your ad wasn’t approved. Create a new ad, or contact us at adstudio@spotify.com."
- Rejection and remediation information and keys.
  Rejection and remediation text and keys.
  rejectionstring
  Rejection reason.
  Example: "Clickthrough URL doesn't work"
  rejection_keystring
  Rejection reason key.
  Example: "AD_POLICY_VIOLATION_REJECTION"
  remediationstring
  Remediation information.
  Example: "Submit a new ad with an updated clickthrough URL."
  remediation_keystring
  Remediation key.
  Example: "AD_POLICY_VIOLATION_REMEDIATION"
- ad_preview_urlstring [uri]
  Preview url of an ad.
  Example: "https://www.adstudio.spotify.com/campaigns/ads/8ae1f562-1b4e-11ee-be56-0242ac120002/preview"
- advertiser_namestring
  Name of the advertiser
  Length between 2 and 25Example: "Heart Dance Recordings"
- Assets for the ad.
  asset_idstring [uuid]
  Required
  A unique identifier for an AUDIO, VIDEO or IMAGE asset.
  Supported content-type(s): Example: "ce4ff15e-f04d-48b9-9ddf-fb3c85fbd57a"
  companion_asset_idstring [uuid]
  Required
  A unique identifier for an IMAGE asset.
  Supported content-type(s): Example: "ce4ff15e-f04d-48b9-9ddf-fb3c85fbd57a"
  logo_asset_idstring [uuid]
  Required
  A unique identifier for an IMAGE asset.
  Supported content-type(s): Example: "ce4ff15e-f04d-48b9-9ddf-fb3c85fbd57a"
  canvas_asset_idstring [uuid]
  A unique identifier for an IMAGE or VIDEO asset with 9:16 aspect ratio.
  Supported content-type(s): Example: "ce4ff15e-f04d-48b9-9ddf-fb3c85fbd57a"
- namestring
  Name given to identify the ad.
  Length between 2 and 200Example: "New Ad"
- taglinestring
  Tagline to give listeners more context about your company or product. This will be displayed in the CTA card leavebehind.
  Pattern: ^\S.*\S$Length between 2 and 40Example: "Good Food for Good Dogs"
- Array maximum length: 11
  Third party viewability tracking via partner and url
  measurement_partnerstring
  Name of the third-party measurement partner.
  Allowed values: "IAS", "DCM", "UNSET"Example: "IAS"
  urlstring
  Third-party tracking URL.
  Example: "https://www.example.com/your-landing-page/?utm_campaign=test-campaign&utm_source=email"

Response sample

{  "paging": {    "page_size": 50,    "total_results": 116,    "offset": 0  },  "ads": [    {      "id": "ce4ff15e-f04d-48b9-9ddf-fb3c85fbd57a",      "call_to_action": {        "text": "LEARN_MORE",        "language": "ENGLISH",        "clickthrough_url": "https://www.spotify.com"      },      "created_at": "2026-01-23T04:56:07Z",      "updated_at": "2026-01-23T04:56:07Z",      "start_time": "2026-01-24T00:00:00Z",      "end_time": "2026-02-24T23:59:59Z",      "delivery": "ON",      "ad_set_id": "ce4ff15e-f04d-48b9-9ddf-fb3c85fbd57a",      "status": "PENDING",      "reject_reason": "Your ad wasn’t approved. Create a new ad, or contact us at adstudio@spotify.com.",      "ad_preview_url": "https://www.adstudio.spotify.com/campaigns/ads/8ae1f562-1b4e-11ee-be56-0242ac120002/preview",      "advertiser_name": "Heart Dance Recordings",      "assets": {        "asset_id": "ce4ff15e-f04d-48b9-9ddf-fb3c85fbd57a",        "companion_asset_id": "ce4ff15e-f04d-48b9-9ddf-fb3c85fbd57a",        "logo_asset_id": "ce4ff15e-f04d-48b9-9ddf-fb3c85fbd57a"      },      "name": "Entity_1",      "tagline": "Good Food for Good Dogs",      "third_party_tracking": [        {          "measurement_partner": "IAS",          "url": "https://www.example.com/your-landing-page/?utm_campaign=test-campaign&utm_source=email"        }      ],      "ad_account_id": "ce4ff15e-f04d-48b9-9ddf-fb3c85fbd57a"    },    {      "id": "ce4ff15e-f04d-48b9-9ddf-fb3c85fbd57a",      "call_to_action": {        "text": "LEARN_MORE",        "language": "ENGLISH",        "clickthrough_url": "https://www.spotify.com"      },      "created_at": "2026-01-23T04:56:07Z",      "updated_at": "2026-01-23T04:56:07Z",      "start_time": "2026-01-24T00:00:00Z",      "end_time": "2026-02-24T23:59:59Z",      "delivery": "ON",      "ad_set_id": "ce4ff15e-f04d-48b9-9ddf-fb3c85fbd57a",      "status": "PENDING",      "reject_reason": "Your ad wasn’t approved. Create a new ad, or contact us at adstudio@spotify.com.",      "ad_preview_url": "https://www.adstudio.spotify.com/campaigns/ads/8ae1f562-1b4e-11ee-be56-0242ac120002/preview",      "advertiser_name": "Heart Dance Recordings",      "assets": {        "asset_id": "ce4ff15e-f04d-48b9-9ddf-fb3c85fbd57a",        "companion_asset_id": "ce4ff15e-f04d-48b9-9ddf-fb3c85fbd57a",        "logo_asset_id": "ce4ff15e-f04d-48b9-9ddf-fb3c85fbd57a"      },      "name": "Entity_1",      "tagline": "Good Food for Good Dogs",      "third_party_tracking": [        {          "measurement_partner": "IAS",          "url": "https://www.example.com/your-landing-page/?utm_campaign=test-campaign&utm_source=email"        }      ],      "ad_account_id": "ce4ff15e-f04d-48b9-9ddf-fb3c85fbd57a"    }  ]}