Skip to content
Ads APIReferences / campaigns / Get Campaigns by Ad Account ID

Get Campaigns by Ad Account ID

Returns list of campaigns linked to an ad account.

Request

  • ad_account_id
    string [uuid]
    Required

    A unique identifier for an Ad Account.

    Example: ce4ff15e-f04d-48b9-9ddf-fb3c85fbd57a
  • campaign_ids
    array of strings

    A list of campaigns to return.

    A unique identifier for the entity.

    Example: campaign_ids=ce4ff15e-f04d-48b9-9ddf-fb3c85fbd57a
  • fields
    array of strings
    Unique items

    Subset of campaign fields to be returned.

    Array minimum length: 1Example: fields=NAME&fields=CREATED_AT&fields=STATUS
    Allowed values: "ID", "NAME", "CREATED_AT", "UPDATED_AT", "STATUS", "PURCHASE_ORDER", "OBJECTIVE", "MEASUREMENT_METADATA"
  • sort_field
    string

    Field by which to sort campaigns.

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

    Field by which to order the results of the query.

    Default: sort_direction=DESCAllowed values: "ASC", "DESC"Example: sort_direction=ASC
  • 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

Response

A list of campaigns.

    • page_size
      integer [int32]
    • total_results
      integer [int32]
    • offset
      integer [int32]
    • current_page
      integer [int32]
    • id
      string [uuid]

      A unique identifier for the entity.

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

      Name given to identify your campaign.

      Pattern: ^\S.*\S$Length between 2 and 200Example: "Spotify Ads Summer Campaign 2022"
    • 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"
    • purchase_order
      string

      A purchase order number, to be shown on your invoice, for your own personal organization.

      Length between 2 and 45Example: "ORDER_1"
    • status
      string

      Current state of campaign.

      Allowed values: "UNSET", "ACTIVE", "PAUSED", "ARCHIVED", "UNRECOGNIZED"Example: "ACTIVE"
    • objective
      string

      Objective for a campaign. UNSET should not be used.

      Default: "EVEN_IMPRESSION_DELIVERY"Allowed values: "UNSET", "REACH", "EVEN_IMPRESSION_DELIVERY", "CLICKS", "VIDEO_VIEWS", "PODCAST_STREAMS"Example: "EVEN_IMPRESSION_DELIVERY"

Response sample

{  "paging": {    "page_size": 0,    "total_results": 0,    "offset": 0,    "current_page": 0  },  "campaigns": [    {      "id": "ce4ff15e-f04d-48b9-9ddf-fb3c85fbd57a",      "name": "Spotify Ads Summer Campaign 2022",      "created_at": "2026-01-23T04:56:07Z",      "updated_at": "2026-01-23T04:56:07Z",      "purchase_order": "ORDER_1",      "status": "ACTIVE",      "objective": "EVEN_IMPRESSION_DELIVERY"    }  ]}