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 value:"ce4ff15e-f04d-48b9-9ddf-fb3c85fbd57a"
- fieldsarray of stringsUnique 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_fieldstring
Field by which to sort campaigns.
Example value:"CREATED_AT"
Default value:"CREATED_AT"
Allowed values:"ID"
,"NAME"
,"CREATED_AT"
,"UPDATED_AT"
,"STATUS"
- sort_directionstring
Field by which to order the results of the query.
Example value:"ASC"
Default value:"DESC"
Allowed values:"ASC"
,"DESC"
- limitinteger
Limit or page size for a given response.
Example value:50
Default value:50
Range:1
-50
- offsetinteger
Starting position of the next record to assist in data pagination.
Example value:0
Default value: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 value:"ce4ff15e-f04d-48b9-9ddf-fb3c85fbd57a"
- namestring
Name given to identify your campaign.
Example value:"Spotify Ads Summer Campaign 2022"
Pattern:^\S.*\S$
Length between2
and120
- created_atstring [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_atstring [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_orderstring
A purchase order number, to be shown on your invoice, for your own personal organization.
Example value:"ORDER_1"
Length between2
and45
- statusstring
Current state of campaign.
Example value:"ACTIVE"
Allowed values:"UNSET"
,"ACTIVE"
,"PAUSED"
,"ARCHIVED"
,"UNRECOGNIZED"
- objectivestring
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" } ]}