Skip to main content
GET
/
v1
/
campaigns
curl -X GET "https://api.adrelay.dev/v1/campaigns?platform=google_ads&status=ACTIVE&limit=25" \
  -H "X-API-Key: $ADRELAY_API_KEY"
{
  "unified": [
    {
      "id": "camp_abc123",
      "platform": "google_ads",
      "remote_id": "123456789",
      "name": "Summer Sale 2026",
      "status": "ACTIVE",
      "goal": "CONVERSIONS",
      "budget_amount": 50.00,
      "budget_period": "DAILY",
      "currency": "USD",
      "created_at": "2026-03-01T12:00:00Z",
      "updated_at": "2026-03-15T08:30:00Z"
    }
  ],
  "pagination": {
    "next_cursor": "eyJpZCI6ImNhbXBfYWJjMTIzIn0=",
    "has_more": true
  }
}
curl -X GET "https://api.adrelay.dev/v1/campaigns?platform=google_ads&status=ACTIVE&limit=25" \
  -H "X-API-Key: $ADRELAY_API_KEY"
{
  "unified": [
    {
      "id": "camp_abc123",
      "platform": "google_ads",
      "remote_id": "123456789",
      "name": "Summer Sale 2026",
      "status": "ACTIVE",
      "goal": "CONVERSIONS",
      "budget_amount": 50.00,
      "budget_period": "DAILY",
      "currency": "USD",
      "created_at": "2026-03-01T12:00:00Z",
      "updated_at": "2026-03-15T08:30:00Z"
    }
  ],
  "pagination": {
    "next_cursor": "eyJpZCI6ImNhbXBfYWJjMTIzIn0=",
    "has_more": true
  }
}

Authorizations

X-API-Key
string
header
required

Query Parameters

platform
enum<string>
Available options:
GOOGLE,
META,
TIKTOK,
LINKEDIN,
PINTEREST,
REDDIT
organization_id
string
status
enum<string>
Available options:
UNSPECIFIED,
ACTIVE,
PAUSED,
ARCHIVED,
DRAFT,
SCHEDULED_FOR_DELETION
cursor
string
limit
integer
default:25
Required range: 1 <= x <= 100

Response

Paginated list of campaigns

data
object[]
required
pagination
object
required