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
- fieldsarray of stringsUnique items
Subset of campaign fields to be returned.
Array minimum length:1
Example:fields=NAME&fields=CREATED_AT&fields=STATUS
Allowed values:"ID"
,"NAME"
,"CREATED_AT"
,"UPDATED_AT"
,"STATUS"
,"PURCHASE_ORDER"
,"OBJECTIVE"
,"MEASUREMENT_METADATA"
- sort_fieldstring
Field by which to sort campaigns.
Default:sort_field=CREATED_AT
Allowed 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=DESC
Allowed values:"ASC"
,"DESC"
Example:sort_direction=ASC
- limitinteger
Limit or page size for a given response.
Default:limit=50
Range:1
-50
Example:limit=50
- offsetinteger
Starting position of the next record to assist in data pagination.
Default:offset=0
Example: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 between2
and120
Example:"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 between2
and45
Example:"ORDER_1"
- statusstring
Current state of campaign.
Allowed values:"UNSET"
,"ACTIVE"
,"PAUSED"
,"ARCHIVED"
,"UNRECOGNIZED"
Example:"ACTIVE"
- objectivestring
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" } ]}