API ReferenceCampaigns
List campaigns
Returns the campaigns belonging to your client account.
Returns the campaigns belonging to your client account.
Authorization
clientKey AuthorizationBearer <token>
Your Oppizi client key. Send it as Authorization: Bearer <client-key>. Scoped to your client account only.
In: header
Query Parameters
limit?integer
Maximum number of campaigns to return (1-100, default 20).
Range
1 <= value <= 100Default
20status?string
Filter by campaign status.
Value in
- "DRAFT"
- "SCHEDULED"
- "ACTIVE"
- "COMPLETED"
- "CANCELLED"
Response Body
application/json
application/json
curl -X GET "https://example.com/client/campaigns"{ "success": true, "data": { "nodes": [ { "id": "cmp_123", "name": "Spring flyer drop — Paris", "status": "DRAFT", "type": "HANDTOHAND", "city": "Paris", "country": "FR", "startDate": "2026-03-01", "endDate": "2026-03-31", "flyerQuantity": 50000, "distributed": 42310 } ], "totalCount": 1 }}{ "success": false, "error": "Unauthorized"}