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

# List Campaigns

List all SMS campaigns with pagination and filtering.

<ParamField query="page" type="integer">
  Page number (default: 1)
</ParamField>

<ParamField query="page_size" type="integer">
  Items per page (default: 20, max: 100)
</ParamField>

<ParamField query="status" type="string">
  Filter by status (draft, scheduled, running, paused, completed, cancelled)
</ParamField>

<ParamField query="search" type="string">
  Search term
</ParamField>

## Success Response (200)

<ResponseField name="count" type="integer">
  Total number of campaigns
</ResponseField>

<ResponseField name="next" type="string">
  URL to next page (nullable)
</ResponseField>

<ResponseField name="previous" type="string">
  URL to previous page (nullable)
</ResponseField>

<ResponseField name="results" type="array">
  Array of campaign objects
</ResponseField>

<ResponseExample>
  ```json theme={null}
  {
    "count": 25,
    "next": "https://mifumosms.mifumolabs.com/api/messaging/campaigns/?page=2",
    "previous": null,
    "results": [
      {
        "id": "550e8400-e29b-41d4-a716-446655440000",
        "name": "Holiday Promotion",
        "message": "Special holiday offer! Get 20% off",
        "status": "scheduled",
        "scheduled_at": "2025-12-01T10:00:00Z",
        "total_recipients": 1000,
        "sent": 0,
        "delivered": 0,
        "failed": 0,
        "created_at": "2025-11-27T10:30:00Z",
        "updated_at": "2025-11-27T10:30:00Z"
      }
    ]
  }
  ```
</ResponseExample>