Ads API •References / 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 value: "ce4ff15e-f04d-48b9-9ddf-fb3c85fbd57a"
fields
array of strings
Unique items
Subset of campaign fields to be returned.
Example value: ["NAME","CREATED_AT","STATUS"]Array minimum length: 1
Allowed values: "ID", "NAME", "CREATED_AT", "UPDATED_AT", "STATUS", "PURCHASE_ORDER", "OBJECTIVE"
sort_field
string
Field by which to sort campaigns.
Example value: "CREATED_AT"Default value: "CREATED_AT"Allowed values: "ID", "NAME", "CREATED_AT", "UPDATED_AT", "STATUS"
sort_direction
string
Field by which to order the results of the query.
Example value: "ASC"Default value: "DESC"Allowed values: "ASC", "DESC"
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

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 value: "ce4ff15e-f04d-48b9-9ddf-fb3c85fbd57a"
- name
  string
  Name given to identify your campaign.
  Example value: "Spotify Ads Summer Campaign 2022"Pattern: ^\S.*\S$Length between 2 and 120
- 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"
- purchase_order
  string
  A purchase order number, to be shown on your invoice, for your own personal organization.
  Example value: "ORDER_1"Length between 2 and 45
- status
  string
  Current state of campaign.
  Example value: "ACTIVE"Allowed values: "UNSET", "ACTIVE", "PAUSED", "ARCHIVED", "UNRECOGNIZED"
- objective
  string
  Objective for a campaign (UNSET cannot be provided as an input)
  Example value: "EVEN_IMPRESSION_DELIVERY"Default value: "EVEN_IMPRESSION_DELIVERY"Allowed values: "REACH", "EVEN_IMPRESSION_DELIVERY", "CLICKS", "UNSET"

Response sample

{  "paging": {    "page_size": 0,    "total_results": 6,    "offset": 1,    "current_page": 5  },  "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"    },    {      "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"    }  ]}