Skip to content
Ads API •References / 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: 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"
  • ad_set_ids
    array of strings

    A list of Ad Set IDs to fetch Ads for only the given subset of Ad Sets

    A unique identifier for the entity.

    Example: ad_set_ids=ce4ff15e-f04d-48b9-9ddf-fb3c85fbd57a
  • limit
    integer

    Limit or page size for a given response.

    Default: limit=50Range: 1 - 50Example: limit=50
  • offset
    integer

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

    Default: offset=0Example: offset=0
  • sort_direction
    string

    Field by which to order the results of the query.

    Default: sort_direction=DESCAllowed values: "ASC", "DESC"Example: sort_direction=ASC
  • sort_field
    string

    Field by which to sort list of ads.

    Default: sort_field=CREATED_ATAllowed values: "CREATED_AT", "ID", "NAME", "STATUS", "UPDATED_AT"Example: sort_field=STATUS

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

      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"

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"    }  ]}