Get Ad by ID
Returns ad for a given ad ID.
Request
- ad_account_idstring [uuid]Required
A unique identifier for an Ad Account.
Example:ce4ff15e-f04d-48b9-9ddf-fb3c85fbd57a
- ad_idstring [uuid]Required
A unique identifier for the entity.
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"
Response
Metadata for the given ad.
- 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 the ad.
Length between2
and200
Example:"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 between2
and40
Example:"Good Food for Good Dogs"
Third party viewability tracking via partner and url
- measurement_partnerstring
Name of the third-party measurement partner.
Allowed values:"IAS"
,"DCM"
Example:"IAS"
- urlstring
Third-party tracking URL.
Example:"https://www.example.com/your-landing-page/?utm_campaign=test-campaign&utm_source=email"
- 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"
- clickthrough_uristring
Spotify URI of desired landing page.
Example:"spotify:track:1Ywk7HecwsfJWy2pxaaQZM"
- keystring
The key used for the call-to-action button text.
Example:"LEARN_MORE"
- 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
{ "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", "canvas_asset_id": "ce4ff15e-f04d-48b9-9ddf-fb3c85fbd57a" }, "name": "New Ad", "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": "string", "language": "string", "clickthrough_url": "https://www.spotify.com", "clickthrough_uri": "spotify:track:1Ywk7HecwsfJWy2pxaaQZM", "key": "LEARN_MORE" }, "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"}