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: 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
name
string
The string that will be used to filter campaigns by name. The filter is case-insensitive and will match any campaign that contains the given string in its name.
ad_set_statuses
array of strings
Unique items
The set of enums that will be used to filter campaigns by their ad set statuses. The filter will match any campaign that has at least one ad set with the given status.
Status of the ad set.
Allowed values: "ACTIVE", "APPROVED", "ARCHIVED", "COMPLETED", "PENDING_APPROVAL", "READY", "REJECTED"Example: ad_set_statuses=ACTIVE
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"    }  ]}