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 stringsUnique items
Subset of ad fields to be returned.
Array minimum length:1
Example: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_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
- limitinteger
Limit or page size for a given response.
Default:limit=50
Range:1
-50
Example:limit=50
- offsetinteger
Starting position of the next record to assist in data pagination.
Default:offset=0
Example:offset=0
- sort_directionstring
Field by which to order the results of the query.
Default:sort_direction=DESC
Allowed values:"ASC"
,"DESC"
Example:sort_direction=ASC
- sort_fieldstring
Field by which to sort list of ads.
Default:sort_field=CREATED_AT
Allowed 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]
- advertiser_namestring
Name of the advertiser
Length between2
and25
Example:"Heart Dance Recordings"
Assets for the ad.
- asset_idstring [uuid]Required
A unique identifier for an AUDIO or VIDEO 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 your entity.
Pattern:^\S.*\S$
Length between2
and120
Example:"Entity_1"
- 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 between2
and40
Example:"Good Food for Good Dogs"
- 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.
- textstring
- languagestring
- clickthrough_urlstringRequired
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"
- 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."
- ad_preview_urlstring [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" } ]}