List campaigns | Sarvam API Docs

List campaigns in the workspace with optional filtering by status, search, sorting, and pagination.

org_idstringRequired

workspace_idstringRequired

campaign_statusenum or nullOptional

Campaign lifecycle status: scheduled → active → ended. Can be paused or cancelled at any point.

Allowed values:

offsetintegerOptional>=0Defaults to 0

Number of records to skip

limitintegerOptional1-100Defaults to 10

Number of records to return (max 100)

sort_bystring or nullOptionalDefaults to created_at

Field to sort by

sort_orderstring or nullOptionalDefaults to desc

Sort order (asc or desc)

searchstring or nullOptional

Search query string

Successful Response

itemslist of objects

List of campaigns on this page

totalinteger

Total number of campaigns matching the query

limitinteger

Maximum number of items per page

offsetinteger

Number of items skipped

next_page_uristring or null

URI to fetch the next page, or null if this is the last page

prev_page_uristring or null

URI to fetch the previous page, or null if this is the first page

422

Unprocessable Entity Error

1	{
2	"items": [
3	{
4	"name": "Q1 Payment Reminders",
5	"campaign_id": "camp-a1b2c3d4",
6	"status": "scheduled",
7	"app_id": "payment-reminder-agent",
8	"created_by": "user@company.com",
9	"created_at": "2026-03-28T10:00:00Z",
10	"updated_at": "2026-03-28T10:00:00Z",
11	"description": "Remind customers about upcoming payment due dates",
12	"app_type": "agent",
13	"app_version": 2,
14	"updated_by": null
15	}
16	],
17	"total": 1,
18	"limit": 10,
19	"offset": 0,
20	"next_page_uri": null,
21	"prev_page_uri": null
22	}

$	curl https://apps.sarvam.ai/api/scheduling/v1/orgs/org_id/workspaces/workspace_id/campaigns \
>	-u "<username>:<password>"