Skip to content
Ads APIReferences / ads / Get Ads by Ad Account ID

Get Ads by Ad Account ID

Returns a list of ads for the given ad account.

Request

  • ad_account_id
    string [uuid]
    Required

    A unique identifier for an Ad Account.

    Example value: "ce4ff15e-f04d-48b9-9ddf-fb3c85fbd57a"
  • fields
    array of strings
    Unique 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"
  • limit
    integer

    Limit or page size for a given response.

    Example value: 50Default value: 50Range: 1 - 50
  • offset
    integer

    Starting position of the next record to assist in data pagination.

    Example value: 0Default value: 0
  • sort_direction
    string

    Field by which to order the results of the query.

    Example value: "ASC"Default value: "DESC"Allowed values: "ASC", "DESC"
  • sort_field
    string

    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_size
      integer [int32]
    • total_results
      integer [int32]
    • offset
      integer [int32]
    • current_page
      integer [int32]
    • advertiser_name
      string

      Name of the advertiser

      Example value: "Heart Dance Recordings"Length between 2 and 25
    • Assets for the ad.

    • name
      string

      Name given to identify your entity.

      Example value: "Entity_1"Pattern: ^\S.*\S$Length between 2 and 120
    • tagline
      string

      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 between 2 and 40
    • id
      string [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_at
      string [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_at
      string [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"
    • delivery
      string

      Toggles the delivery of the entity ON or OFF.

      Allowed values: "ON", "OFF"
    • ad_set_id
      string [uuid]

      A unique identifier for the entity.

      Example value: "ce4ff15e-f04d-48b9-9ddf-fb3c85fbd57a"
    • status
      string

      Status of the ad.

      Example value: "PENDING"Allowed values: "ACTIVE", "APPROVED", "ARCHIVED", "PENDING", "PENDING_APPROVAL", "REJECTED", "UNRECOGNIZED"
    • reject_reason
      string

      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_url
      string [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"    }  ]}