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

# Dashboard Metrics

Get detailed metrics for a specific time period.

<ParamField query="period" type="string">
  Time period (7d, 30d, 90d, 1y)
</ParamField>

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

## Success Response (200)

<ResponseField name="period" type="string">
  Selected time period
</ResponseField>

<ResponseField name="metrics" type="object">
  Metrics object containing various statistics
</ResponseField>

<ResponseField name="metrics.messages_sent" type="integer">
  Number of messages sent in the period
</ResponseField>

<ResponseField name="metrics.messages_delivered" type="integer">
  Number of messages delivered in the period
</ResponseField>

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

<ResponseField name="metrics.cost" type="float">
  Total cost for the period
</ResponseField>

<ResponseField name="metrics.contacts_added" type="integer">
  Number of contacts added in the period
</ResponseField>

<ResponseField name="metrics.campaigns_created" type="integer">
  Number of campaigns created in the period
</ResponseField>

<ResponseField name="daily_breakdown" type="array">
  Daily breakdown of metrics
</ResponseField>

<ResponseExample>
  ```json theme={null}
  {
    "period": "30d",
    "metrics": {
      "messages_sent": 5000,
      "messages_delivered": 4750,
      "delivery_rate": 95.0,
      "cost": 250.00,
      "contacts_added": 150,
      "campaigns_created": 5
    },
    "daily_breakdown": [
      {
        "date": "2025-11-01",
        "sent": 200,
        "delivered": 190,
        "cost": 10.00
      }
    ]
  }
  ```
</ResponseExample>