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_id
string [uuid]
Required
A unique identifier for an Ad Account.
Example: ce4ff15e-f04d-48b9-9ddf-fb3c85fbd57a
fields
array 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", "ID", "NAME", "REJECT_REASON", "STATUS", "TAGLINE", "THIRD_PARTY_TRACKING", "UPDATED_AT"
ad_set_ids
array 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_ids
array 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
name
string
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.
statuses
array 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
limit
integer
Limit or page size for a given response.
Default: limit=50Range: 1 - 50Example: limit=50
offset
integer
Starting position of the next record to assist in data pagination.
Default: offset=0Example: offset=0
sort_direction
string
Field by which to order the results of the query.
Default: sort_direction=DESCAllowed values: "ASC", "DESC"Example: sort_direction=ASC
sort_field
string
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_size
  integer [int32]
- total_results
  integer [int32]
- offset
  integer [int32]
- current_page
  integer [int32]
- advertiser_name
  string
  Name of the advertiser
  Length between 2 and 25Example: "Heart Dance Recordings"
- Assets for the ad.
  asset_id
  string [uuid]
  Required
  A unique identifier for an AUDIO or VIDEO asset.
  Supported content-type(s): Example: "ce4ff15e-f04d-48b9-9ddf-fb3c85fbd57a"
  companion_asset_id
  string [uuid]
  Required
  A unique identifier for an IMAGE asset.
  Supported content-type(s): Example: "ce4ff15e-f04d-48b9-9ddf-fb3c85fbd57a"
  logo_asset_id
  string [uuid]
  Required
  A unique identifier for an IMAGE asset.
  Supported content-type(s): Example: "ce4ff15e-f04d-48b9-9ddf-fb3c85fbd57a"
  canvas_asset_id
  string [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"
- name
  string
  Name given to identify the ad.
  Length between 2 and 200Example: "New Ad"
- tagline
  string
  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_partner
  string
  Name of the third-party measurement partner.
  Allowed values: "IAS", "DCM", "UNSET"Example: "IAS"
  url
  string
  Third-party tracking URL.
  Example: "https://www.example.com/your-landing-page/?utm_campaign=test-campaign&utm_source=email"
- id
  string [uuid]
  A unique identifier for the entity.
  Example: "ce4ff15e-f04d-48b9-9ddf-fb3c85fbd57a"
- The metadata for the behavior of the call-to-action button.
  text
  string
  language
  string
  clickthrough_url
  string
  Required
  The link to the ads desired landing page.
  Example: "https://www.spotify.com"
  key
  string
  The key used for the call-to-action button text.
  Example: "LEARN_MORE"
- created_at
  string [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_at
  string [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"
- delivery
  string
  Toggles the delivery of the entity ON or OFF.
  Allowed values: "ON", "OFF"Example: "ON"
- ad_set_id
  string [uuid]
  A unique identifier for the entity.
  Example: "ce4ff15e-f04d-48b9-9ddf-fb3c85fbd57a"
- status
  string
  Status of the ad.
  Allowed values: "ACTIVE", "APPROVED", "ARCHIVED", "PENDING", "PENDING_APPROVAL", "REJECTED", "UNRECOGNIZED"Example: "PENDING"
- reject_reason
  string
  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."
- ad_preview_url
  string [uri]
  Preview url of an ad.
  Example: "https://www.adstudio.spotify.com/preview/8ae1f562-1b4e-11ee-be56-0242ac120002"

Response sample

{  "paging": {    "page_size": 50,    "total_results": 116,    "offset": 0  },  "ads": [    {      "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"        }      ],      "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",      "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/preview/8ae1f562-1b4e-11ee-be56-0242ac120002",      "ad_account_id": "ce4ff15e-f04d-48b9-9ddf-fb3c85fbd57a",      "campaign_id": "ce4ff15e-f04d-48b9-9ddf-fb3c85fbd57a"    },    {      "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"        }      ],      "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",      "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/preview/8ae1f562-1b4e-11ee-be56-0242ac120002",      "ad_account_id": "ce4ff15e-f04d-48b9-9ddf-fb3c85fbd57a",      "campaign_id": "ce4ff15e-f04d-48b9-9ddf-fb3c85fbd57a"    }  ]}