Skip to main content
GET
/
campaigns
List Campaigns
curl --request GET \
  --url https://api.kakiyo.com/v1/campaigns \
  --header 'Authorization: Bearer <token>'
[
  {
    "id": "campaign_12345abcde",
    "name": "Q2 Sales Outreach",
    "status": "active",
    "agent": "agent_abcdef123456",
    "product": "prod_123456789",
    "createdAt": "2023-06-15T10:30:00Z",
    "stats": {
      "prospects": 150,
      "prospectsAnswers": 42,
      "messages": 320,
      "qualified": 18,
      "closed": 5
    }
  }
]

​
Overview

List campaigns for the authenticated team. This endpoint returns a plain array of campaigns.

​
Backward Compatibility

  • Default behavior remains unchanged: GET /v1/campaigns returns a plain array of campaigns.
  • Existing integrations do not need to change anything.

​
Optional Pagination Params

  • limit is optional.
  • If both pagination params are omitted, the endpoint returns the full list.
  • If either pagination param is provided, pagination mode is used.
  • Default offset: 0
  • Maximum: 100
  • Response shape does not change.

​
Examples

Legacy full-list request: 
curl -X GET "https://api.kakiyo.com/v1/campaigns" \
  -H "Authorization: Bearer YOUR_API_KEY"
With an explicit limit: 
curl -X GET "https://api.kakiyo.com/v1/campaigns?limit=50" \
  -H "Authorization: Bearer YOUR_API_KEY"
With limit and offset: 
curl -X GET "https://api.kakiyo.com/v1/campaigns?limit=25&offset=25" \
  -H "Authorization: Bearer YOUR_API_KEY"
Legacy response: 
[
  {
    "id": "campaign_123",
    "name": "Q4 Enterprise Outreach",
    "status": "active",
    "agent": "agent_123",
    "product": "product_123",
    "createdAt": "2026-03-01T12:00:00.000Z",
    "stats": {
      "prospects": 120,
      "prospectsAnswers": 14,
      "messages": 38,
      "qualified": 3,
      "closed": 0
    }
  }
]

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

​
limit
integer<int32>
default:20

Maximum number of campaigns to return

Required range: x <= 100
​
after
string

Cursor for pagination

Response

List of campaigns

​
id
string
Example:

"campaign_12345abcde"

​
name
string
Example:

"Q2 Sales Outreach"

​
status
enum<string>
Available options:
draft,
active,
paused,
completed
Example:

"active"

​
agent
string
Example:

"agent_abcdef123456"

​
product
string
Example:

"prod_123456789"

​
createdAt
string<date-time>
Example:

"2023-06-15T10:30:00Z"

​
stats
object
Last modified on March 19, 2026