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_idstring [uuid]
Required
A unique identifier for an Ad Account.
Example: ce4ff15e-f04d-48b9-9ddf-fb3c85fbd57a
campaign_idsarray of strings
A list of campaigns to return.
A unique identifier for the entity.
Example: campaign_ids=ce4ff15e-f04d-48b9-9ddf-fb3c85fbd57a
namestring
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_statusesarray 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", "ACTIVE_RESTRICTED", "APPROVED", "ARCHIVED", "COMPLETED", "PENDING_APPROVAL", "READY", "REJECTED"Example: ad_set_statuses=ACTIVE
statusesarray of strings
Filter by campaign's status
Current state of campaign.
Allowed values: "UNSET", "ACTIVE", "PAUSED", "ARCHIVED", "AGENT_CONTROLLED", "ACTIVE_RESTRICTED", "PENDING_ADVERTISER_REVIEW", "UNRECOGNIZED"Example: statuses=ACTIVE
fieldsarray 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", "DELIVERY"
sort_fieldstring
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_directionstring
Field by which to order the results of the query.
Default: sort_direction=DESCAllowed values: "ASC", "DESC"Example: sort_direction=ASC
limitinteger
Limit or page size for a given response.
Default: limit=50Range: 1 - 50Example: limit=50
offsetinteger
Starting position of the next record to assist in data pagination.
Default: offset=0Example: offset=0

Response

A list of campaigns.

- page_sizeinteger [int32]
- total_resultsinteger [int32]
- offsetinteger [int32]
- current_pageinteger [int32]
- idstring [uuid]
  A unique identifier for the entity.
  Example: "ce4ff15e-f04d-48b9-9ddf-fb3c85fbd57a"
- namestring
  Name given to identify your campaign.
  Pattern: ^\S.*\S$Length between 2 and 200Example: "Spotify Ads Summer Campaign 2022"
- created_atstring [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_atstring [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_orderstring
  A purchase order number, to be shown on your invoice, for your own personal organization.
  Length between 2 and 45Example: "ORDER_1"
- statusstring
  Current state of campaign.
  Allowed values: "UNSET", "ACTIVE", "PAUSED", "ARCHIVED", "AGENT_CONTROLLED", "ACTIVE_RESTRICTED", "PENDING_ADVERTISER_REVIEW", "UNRECOGNIZED"Example: "ACTIVE"
- objectivestring
  Deprecated
  Deprecated: Use delivery_goal_group and delivery_goal on ad sets instead. 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", "APP_INSTALLS", "WEBSITE_VISITS"Example: "EVEN_IMPRESSION_DELIVERY"
- delivery_goal_groupstring
  deliveryGoal group grouping selection for a campaign.
  Allowed values: "UNSET", "AWARENESS", "WEBSITE_TRAFFIC", "APP_PROMOTION", "ENGAGEMENT_ON_SPOTIFY", "LEAD_GEN"

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",      "delivery_goal_group": "UNSET"    }  ]}