> ## 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.

# Analytics Overview

Get comprehensive analytics overview for a date range.

<ParamField query="start_date" type="date">
  Start date (YYYY-MM-DD)
</ParamField>

<ParamField query="end_date" type="date">
  End date (YYYY-MM-DD)
</ParamField>

<Warning>
  Requires authentication. Include the access token in the Authorization header.
</Warning>

## Success Response (200)

<ResponseField name="period" type="object">
  Period object with start and end dates
</ResponseField>

<ResponseField name="overview" type="object">
  Overview statistics
</ResponseField>

<ResponseField name="overview.total_messages" type="integer">
  Total messages in the period
</ResponseField>

<ResponseField name="overview.delivered" type="integer">
  Total delivered messages
</ResponseField>

<ResponseField name="overview.failed" type="integer">
  Total failed messages
</ResponseField>

<ResponseField name="overview.delivery_rate" type="float">
  Delivery rate percentage
</ResponseField>

<ResponseField name="overview.total_cost" type="float">
  Total cost
</ResponseField>

<ResponseField name="overview.average_cost_per_message" type="float">
  Average cost per message
</ResponseField>

<ResponseField name="by_status" type="object">
  Breakdown by status
</ResponseField>

<ResponseField name="by_day" type="array">
  Daily breakdown array
</ResponseField>

<ResponseExample>
  ```json theme={null}
  {
    "period": {
      "start": "2025-11-01T00:00:00Z",
      "end": "2025-11-27T23:59:59Z"
    },
    "overview": {
      "total_messages": 10000,
      "delivered": 9500,
      "failed": 500,
      "delivery_rate": 95.0,
      "total_cost": 500.00,
      "average_cost_per_message": 0.05
    },
    "by_status": {
      "sent": 10000,
      "delivered": 9500,
      "failed": 500
    },
    "by_day": [
      {
        "date": "2025-11-01",
        "sent": 500,
        "delivered": 475,
        "failed": 25
      }
    ]
  }
  ```
</ResponseExample>