Ads API •References / ads / Get Ad by ID

Get Ad by ID

Returns ad for a given ad ID.

Request

ad_account_id
string [uuid]
Required
A unique identifier for an Ad Account.
Example: ce4ff15e-f04d-48b9-9ddf-fb3c85fbd57a
ad_id
string [uuid]
Required
A unique identifier for the entity.
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", "END_TIME", "ID", "NAME", "REJECT_REASON", "REJECT_REASONS", "START_TIME", "STATUS", "TAGLINE", "THIRD_PARTY_TRACKING", "UPDATED_AT", "DV_CLIENT_CODE"

Response

Metadata for the given ad.

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.
- key
  string
  The identifier used for the call-to-action button. This will be translated using the locale.
  Example: "LEARN_MORE"
- text
  string
  The post-translation text used for the call-to-action-button-text
  Example: "Learn more"
- language
  string
- clickthrough_url
  string
  Required
  The link to the ads desired landing page.
  Example: "https://www.spotify.com"
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"
start_time
string [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_time
string [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"
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."
Rejection and remediation information and keys.
Rejection and remediation text and keys.
- rejection
  string
  Rejection reason.
  Example: "Clickthrough URL doesn't work"
- rejection_key
  string
  Rejection reason key.
  Example: "AD_POLICY_VIOLATION_REJECTION"
- remediation
  string
  Remediation information.
  Example: "Submit a new ad with an updated clickthrough URL."
- remediation_key
  string
  Remediation key.
  Example: "AD_POLICY_VIOLATION_REMEDIATION"
ad_preview_url
string [uri]
Preview url of an ad.
Example: "https://www.adstudio.spotify.com/preview/8ae1f562-1b4e-11ee-be56-0242ac120002"
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, VIDEO or IMAGE 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"

Response sample

{  "id": "ce4ff15e-f04d-48b9-9ddf-fb3c85fbd57a",  "call_to_action": {    "key": "LEARN_MORE",    "text": "Learn more",    "language": "string",    "clickthrough_url": "https://www.spotify.com"  },  "created_at": "2026-01-23T04:56:07Z",  "updated_at": "2026-01-23T04:56:07Z",  "start_time": "2023-09-23T04:56:07Z",  "end_time": "2023-09-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.",  "reject_reasons": [    {      "rejection": "Clickthrough URL doesn't work",      "rejection_key": "AD_POLICY_VIOLATION_REJECTION",      "remediation": "Submit a new ad with an updated clickthrough URL.",      "remediation_key": "AD_POLICY_VIOLATION_REMEDIATION"    }  ],  "ad_preview_url": "https://www.adstudio.spotify.com/preview/8ae1f562-1b4e-11ee-be56-0242ac120002",  "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"    }  ]}