Skip to content
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", "ID", "NAME", "REJECT_REASON", "STATUS", "TAGLINE", "THIRD_PARTY_TRACKING", "UPDATED_AT"

Response

Metadata for the given ad.

  • advertiser_name
    string

    Name of the advertiser

    Length between 2 and 25Example: "Heart Dance Recordings"

  • Assets for the ad.

    • asset_id
      string [uuid]

      A unique identifier for an AUDIO or VIDEO asset.

      Supported content-type(s): Example: "ce4ff15e-f04d-48b9-9ddf-fb3c85fbd57a"
    • companion_asset_id
      string [uuid]

      A unique identifier for an IMAGE asset.

      Supported content-type(s): Example: "ce4ff15e-f04d-48b9-9ddf-fb3c85fbd57a"
    • logo_asset_id
      string [uuid]

      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 your entity.

    Pattern: ^\S.*\S$Length between 2 and 120Example: "Entity_1"
  • 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"

  • Third party viewability tracking via partner and url

    • measurement_partner
      string

      Name of the third-party measurement partner.

      Allowed values: "IAS", "DCM"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"
  • 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"

Links

  • Get Ad Set by ID

    Get an ad set by ID.

  • Get Asset by ID

    Returns asset metadata for a given asset ID.

  • Get Asset by ID

    Returns companion asset metadata for a given asset ID.

  • Get Asset by ID

    Returns logo asset metadata for a given asset ID.

  • Get Asset by ID

    Returns canvas asset metadata for a given asset ID.

    • 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": "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": "string",    "language": "string",    "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"}