List cohorts | Sarvam API Docs

{
  "items": [
    {
      "name": "April Batch 1",
      "cohort_id": "coh-x1y2z3",
      "status": "completed",
      "source_type": "file_upload",
      "created_by": "user@company.com",
      "created_at": "2026-04-01T09:00:00Z",
      "updated_at": "2026-04-01T09:05:00Z",
      "result": {
        "total_records": 10000,
        "valid_records": 9750,
        "rejected_records": 250
      },
      "updated_by": null
    }
  ],
  "total": 1,
  "limit": 10,
  "offset": 0,
  "next_page_uri": null,
  "prev_page_uri": null
}

List all cohorts belonging to a campaign with pagination, sorting, and search.

Path parameters

org_idstringRequired

workspace_idstringRequired

campaign_idstringRequired

Query parameters

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

Response

Successful Response

itemslist of objects

List of cohorts on this page

totalinteger

Total number of cohorts 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

Errors

422

Unprocessable Entity Error

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