List Campaigns

Retrieve all campaigns for an organization

Endpoint

GET https://api.graine.ai/api/v1/campaigns/

Headers

Header	Required	Description
Authorization	Yes	Bearer gat_<token>

Query Parameters

Parameter	Type	Required	Description
organization_id	string	No	Filter by org. Defaults to the token’s org
status	string	No	Filter by status: draft · active · paused · cancelled · completed
skip	integer	No	Pagination offset. Default: 0
limit	integer	No	Page size. Default: 50, max: 200

Example Request

curl "https://api.graine.ai/api/v1/campaigns/?organization_id=org_xyz&status=active&skip=0&limit=50" \
  -H "Authorization: Bearer gat_your_token"

Response

200 OK

[
  {
    "campaign_id": "cmp_abc123",
    "name": "Q2 Insurance Renewals",
    "status": "active",
    "organization_id": "org_xyz",
    "agent_id": "agent_abc123",
    "phone_numbers": ["[phone]"],
    "created_at": "2026-05-01T09:00:00Z",
    "updated_at": "2026-05-10T08:30:00Z"
  },
  {
    "campaign_id": "cmp_def456",
    "name": "Customer Follow-up May",
    "status": "paused",
    "organization_id": "org_xyz",
    "agent_id": "agent_xyz789",
    "phone_numbers": ["[phone]"],
    "created_at": "2026-05-05T10:00:00Z",
    "updated_at": "2026-05-09T14:00:00Z"
  }
]

Code Examples

import requests

url = "https://api.graine.ai/api/v1/campaigns/"
headers = { "Authorization": "Bearer gat_your_token" }
params = {
    "organization_id": "org_xyz",
    "status": "active",
    "skip": 0,
    "limit": 50
}

response = requests.get(url, headers=headers, params=params)
campaigns = response.json()
for c in campaigns:
    print(c["campaign_id"], c["name"], c["status"])

const params = new URLSearchParams({
  organization_id: "org_xyz",
  status: "active",
  skip: 0,
  limit: 50
});

const response = await fetch(
  `https://api.graine.ai/api/v1/campaigns/?${params}`,
  { headers: { Authorization: "Bearer gat_your_token" } }
);
const campaigns = await response.json();
console.log(campaigns);