Ads API •References / Campaigns / Get Campaigns by Ad Account

Get Campaigns by Ad Account

Returns a list of campaigns for a specific ad account.

Request

ad_account_id
string [uuid]
Required
ids
string [uuid]
advertiser_ids
string [uuid]
statuses
array of Campaign Status
List of campaign status types to filter by
Allowed values: "ACTIVE", "PAUSED", "ARCHIVED"Example: statuses=ACTIVE
name
string
sort_field
string
sort_direction
string
page_size
integer
offset
integer
fields
string

Response

- advertiser_id
  string [uuid]
  The unique ID returned when a new advertiser is created.
- created_on
  string [date-time]
  Date the advertiser was created Time is in ISO-8601 format.
- ad_set_ids
  array of strings
  IDs associated with the ad set.
- id
  string [uuid]
  ID associated with the campaign that will contain one to many ad sets within it.
- name
  string
  Name given to identify your campaign.
- status
  string [campaign-status]
  Allowed values: "UNSET", "ACTIVE", "PAUSED", "ARCHIVED", "UNRECOGNIZED"Example: "ACTIVE"
- version
  integer [int64]
  When a campaign is created or updated, it is assigned a new version.

Response sample

{  "campaigns": [    {      "advertiser_id": "za66a2eb-35cf-46a4-8d2e-0j95dfc133r4",      "created_on": "2022-02-07T21:00:00Z",      "ad_set_ids": ["4ec2568b-0b72-11e8-a7af-52010a800891"],      "id": "2g5488b7-0a48-4751-b3b8-701df2d8cd91",      "name": "Spotify Ads Summer Campaign 2022",      "status": "ACTIVE",      "version": 1    },    {      "advertiser_id": "za66a2eb-35cf-46a4-8d2e-0j95dfc133r4",      "created_on": "2022-02-07T21:00:00Z",      "ad_set_ids": ["4ec2568b-0b72-11e8-a7af-52010a800891"],      "id": "2g5488b7-0a48-4751-b3b8-701df2d8cd91",      "name": "Spotify Ads Summer Campaign 2022",      "status": "ACTIVE",      "version": 1    }  ]}