> ## Documentation Index
> Fetch the complete documentation index at: https://docs-dev.setoo.work/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# List SMS campaigns

> Retrieve a paginated list of SMS campaigns

Returns all SMS campaigns configured for the authenticated tenant.

### Query parameters

<ParamField query="page" type="integer" default="1">
  1-based page number.
</ParamField>

<ParamField query="pageSize" type="integer" default="15">
  Items per page (maximum 100).
</ParamField>

<CodeGroup>
  ```bash curl theme={null}
  curl -X GET "https://api.agentic-os.com/api/v1/sms-agent/campaigns?page=1&pageSize=15" \
    -H "Authorization: Bearer $AGENTIC_OS_API_KEY"
  ```

  ```python Python theme={null}
  import requests

  response = requests.get(
      "https://api.agentic-os.com/api/v1/sms-agent/campaigns",
      headers={"Authorization": f"Bearer {API_KEY}"},
      params={"page": 1, "pageSize": 15},
  )
  print(response.json())
  ```

  ```javascript Node theme={null}
  const response = await fetch(
    "https://api.agentic-os.com/api/v1/sms-agent/campaigns?page=1&pageSize=15",
    {
      method: "GET",
      headers: { Authorization: `Bearer ${API_KEY}` },
    },
  );
  const data = await response.json();
  console.log(data);
  ```
</CodeGroup>

### Response

```json theme={null}
{
  "items": [
    {
      "id": "66666666-6666-6666-6666-666666666666",
      "tenantId": "990e8400-e29b-41d4-a716-446655440000",
      "agentId": "11111111-1111-1111-1111-111111111111",
      "name": "Post-Call SMS Follow-up",
      "senderNumber": "+15550199",
      "senderProvider": "TWILIO",
      "isActive": true,
      "templates": [
        {
          "id": "sms_tpl_1",
          "callStatus": "ANSWERED",
          "messageBody": "Hi {{name}}, thanks for your time today!"
        }
      ],
      "createdAt": "2026-06-01T12:00:00.000Z",
      "updatedAt": "2026-06-01T12:00:00.000Z"
    }
  ],
  "total": 1,
  "page": 1,
  "pageSize": 15
}
```