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 value:"ce4ff15e-f04d-48b9-9ddf-fb3c85fbd57a"
- fieldsarray of stringsUnique items
Subset of ad fields to be returned.
Example value:["NAME","CREATED_AT","STATUS"]
Array minimum length:1
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"
- limitinteger
Limit or page size for a given response.
Example value:50
Default value:50
Range:1
-50
- offsetinteger
Starting position of the next record to assist in data pagination.
Example value:0
Default value:0
- sort_directionstring
Field by which to order the results of the query.
Example value:"ASC"
Default value:"DESC"
Allowed values:"ASC"
,"DESC"
- sort_fieldstring
Field by which to sort list of ads.
Example value:"STATUS"
Default value:"CREATED_AT"
Allowed values:"CREATED_AT"
,"ID"
,"NAME"
,"STATUS"
,"UPDATED_AT"
Response
A list of ads.
- page_sizeinteger [int32]
- total_resultsinteger [int32]
- offsetinteger [int32]
- current_pageinteger [int32]
- advertiser_namestring
Name of the advertiser
Example value:"Heart Dance Recordings"
Length between2
and25
Assets for the ad.
- namestring
Name given to identify your entity.
Example value:"Entity_1"
Pattern:^\S.*\S$
Length between2
and120
- taglinestring
Tagline to give listeners more context about your company or product. This will be displayed in the CTA card leavebehind.
Example value:"Good Food for Good Dogs"
Pattern:^\S.*\S$
Length between2
and40
- idstring [uuid]
A unique identifier for the entity.
Example value:"ce4ff15e-f04d-48b9-9ddf-fb3c85fbd57a"
The metadata for the behavior of the call-to-action button.
- created_atstring [date-time]
Date the ad set was created. Time should be in ISO 8601 format using Coordinated Universal Time (UTC) with a zero offset: YYYY-MM-DDTHH:MM:SSZ
Example value:"2026-01-23T04:56:07Z"
- updated_atstring [date-time]
Date the ad set was updated. Time should be in ISO 8601 format using Coordinated Universal Time (UTC) with a zero offset: YYYY-MM-DDTHH:MM:SSZ
Example value:"2026-01-23T04:56:07Z"
- deliverystring
Toggles the delivery of the entity ON or OFF.
Allowed values:"ON"
,"OFF"
- ad_set_idstring [uuid]
A unique identifier for the entity.
Example value:"ce4ff15e-f04d-48b9-9ddf-fb3c85fbd57a"
- statusstring
Status of the ad.
Example value:"PENDING"
Allowed values:"ACTIVE"
,"APPROVED"
,"ARCHIVED"
,"PENDING"
,"PENDING_APPROVAL"
,"REJECTED"
,"UNRECOGNIZED"
- reject_reasonstring
Reason the ad has been put into the REJECTED state (if applicable).
Example value:"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 value:"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" } ]}