# Metrics API

> Aggregate sending metrics for your team.

Source: https://mailvina.com/docs/api-reference/metrics · Base URL: https://api.mailvina.com · Guide: https://mailvina.com/docs/analytics

## Get metrics

Returns totals and rates for the period, plus one row per day.

`GET /metrics`

**Query parameters**

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `days` | `number` | no | 1–90. Default 7. |

**Request**

```bash
curl -X GET 'https://api.mailvina.com/metrics?days=30' \
  -H 'Authorization: Bearer mv_xxxxxxxxx'
```

```js
const res = await fetch('https://api.mailvina.com/metrics?days=30', {
  method: 'GET',
  headers: {
    Authorization: `Bearer ${process.env.MAILVINA_API_KEY}`,
  },
});
const data = await res.json();
```

```python
import os, requests

res = requests.get(
    "https://api.mailvina.com/metrics?days=30",
    headers={"Authorization": f"Bearer {os.environ['MAILVINA_API_KEY']}"},
)
print(res.json())
```

**Response**

```json
{
  "summary": {
    "total": 1200,
    "delivered": 1180,
    "bounced": 12,
    "complained": 1,
    "opened": 640,
    "clicked": 210,
    "queued": 0,
    "failed": 0,
    "deliveryRate": 98.99,
    "bounceRate": 1.01,
    "complaintRate": 0.08,
    "openRate": 54.24,
    "clickRate": 17.8
  },
  "daily": [
    {
      "date": "2026-11-14",
      "total": 100,
      "delivered": 98,
      "bounced": 2,
      "complained": 0,
      "opened": 51,
      "clicked": 17
    }
  ]
}
```