GET
/v1/campaigns/List campaigns
Lists every campaign you own. Add ?status= to filter to one status instead of paging through everything client-side.
Request
| Authorization | Bearer YOUR_API_KEY |
Parameters
| Field | Type | Required | Description |
|---|---|---|---|
| status | enum | Optional | DRAFT | RUNNING | PAUSED | COMPLETED | FAILED | SCHEDULED. Omit for every campaign. |
curl "https://api.stynar.com/v1/campaigns/?status=RUNNING" \
-H "Authorization: Bearer esk_your_key_here"Response
✓ 200 OK
200 response
{
"campaigns": [
{
"campaignId": "cmp_abc123",
"name": "Q3 outbound",
"status": "RUNNING",
"createdAt": "2026-07-01T09:12:00Z"
},
{
"campaignId": "cmp_def456",
"name": "Q2 replay",
"status": "COMPLETED",
"createdAt": "2026-06-02T11:40:00Z"
}
]
}Response fields
Errors
| Status | Code | Meaning |
|---|---|---|
| ✕ 401 Unauthorized | UNAUTHORIZED | Missing, malformed, unknown, revoked, or expired key. |
| ✕ 403 Forbidden | API_ACCESS_DISABLED | Your account doesn't currently have API access. |
| ✕ 403 Forbidden | INSUFFICIENT_SCOPE | The key doesn't have the scope this endpoint requires. |
| ✕ 404 Not Found | NOT_FOUND | Unknown route, or a resource that doesn't exist / isn't yours. |
| ✕ 409 Conflict | CONFLICT | The action can't be applied to the resource's current state. |
| ✕ 429 Too Many Requests | RATE_LIMIT_EXCEEDED | Per-minute or per-second limit hit. |
| ✕ 429 Too Many Requests | QUOTA_EXCEEDED | Monthly quota exhausted. |
| ✕ 500 Internal Server Error | INTERNAL_ERROR | Something broke on Stynar's end. |