Skip to main content
GET
/
campaigns
List campaigns
curl --request GET \
  --url https://api.agentic.scope3.com/api/v2/buyer/campaigns \
  --header 'Authorization: Bearer <token>'
{
  "campaigns": [
    {
      "campaignId": "cmp_987654321",
      "advertiserId": "12345",
      "name": "Summer 2025 Campaign",
      "status": "DRAFT",
      "createdAt": "2025-01-15T10:30:00Z",
      "updatedAt": "2025-01-20T14:45:00Z",
      "brief": "<string>",
      "flightDates": {
        "startDate": "2025-01-15T00:00:00Z",
        "endDate": "2025-03-31T23:59:59Z"
      },
      "budget": {
        "total": 1,
        "currency": "USD",
        "dailyCap": 1,
        "pacing": "EVEN"
      },
      "constraints": {
        "channels": [
          "<string>"
        ],
        "countries": [
          "<string>"
        ]
      },
      "performanceConfig": {
        "optimizationGoal": {
          "eventSourceId": "es_abc123",
          "eventType": "page_view",
          "targetRoas": 4,
          "targetCpa": 25,
          "attributionWindow": {
            "clickThrough": "7d",
            "viewThrough": "1d"
          }
        }
      },
      "productCount": 15
    }
  ],
  "total": 42
}

Authorizations

Authorization
string
header
required

API key or access token

Query Parameters

advertiserId
string

Filter by advertiser ID

Example:

"12345"

status
enum<string>

Filter by campaign status

Available options:
DRAFT,
ACTIVE,
PAUSED,
COMPLETED,
ARCHIVED
take
integer
default:50

Number of results to return (max 250)

Required range: x <= 250
Example:

50

skip
integer
default:0

Number of results to skip for pagination

Required range: 0 <= x <= 9007199254740991
Example:

0

Response

List campaigns

Response containing a paginated list of campaigns

campaigns
object[]
required

List of campaigns

total
integer
required

Total count of campaigns matching the query

Required range: 0 <= x <= 9007199254740991
Example:

42