# Get sending metrics

> Documentation and API reference for Vaartix, the email API for Indian developers.

Source: https://vaartix.com/docs/api/operations/getmetrics/

GET

/metrics

```sh
curl --request GET \
  --url 'https://api.vaartix.com/metrics?days=15' \
  --header 'Authorization: Bearer <token>'
```

Daily counts for the last `days` days (in IST, today included), with delivery, bounce and complaint rates. Counts are per recipient; test-mode emails are not counted. Requires a full-access key.

## Authorizations

-   **[apiKey](https://vaartix.com/docs/api/#apikey)**

## Parameters

### Query Parameters

**days**

integer

default: 15 \>= 1 <= 90

## Responses

### 200

Metrics.

Media typeapplication/json

**object**

**days**

Array<object>

**object**

**day**

string format: date

**sent**

integer

**delivered**

integer

**bounced**

integer

**complained**

integer

**totals**

**object**

**sent**

integer

**delivered**

integer

**bounced**

integer

**complained**

integer

**rates**

Shares of `totals.sent`, from 0 to 1.

**object**

**delivered**

number

**bounced**

number

**complained**

number

**limits**

Above these rates over 7 days (after 100 emails), sending is paused automatically.

**object**

**bounceRate**

number

**complaintRate**

number

**today**

**object**

**sent**

integer

**dailyLimit**

integer

#### Example

```json
{
  "days": [
    {
      "day": "2026-10-28"
    }
  ],
  "rates": {
    "delivered": 0.982,
    "bounced": 0.011,
    "complained": 0.0002
  },
  "limits": {
    "bounceRate": 0.04,
    "complaintRate": 0.0008
  }
}
```

### 401

`unauthorized`: the API key is missing, invalid or revoked.

Media typeapplication/json

**object**

**error**

required

**object**

**type**

required

Stable, machine-readable error type.

string

Allowed values: validation\_error unauthorized forbidden not\_found conflict rate\_limited daily\_quota\_exceeded domain\_not\_verified invalid\_from\_address account\_paused domain\_needs\_review content\_rejected idempotency\_conflict bad\_request internal\_error

**message**

required

Human-readable explanation, safe to show to developers.

string

#### Example

```json
{
  "error": {
    "type": "validation_error"
  }
}
```

### 403

`forbidden`: the key cannot do this, for example a send-only key on a management endpoint.

Media typeapplication/json

**object**

**error**

required

**object**

**type**

required

Stable, machine-readable error type.

string

Allowed values: validation\_error unauthorized forbidden not\_found conflict rate\_limited daily\_quota\_exceeded domain\_not\_verified invalid\_from\_address account\_paused domain\_needs\_review content\_rejected idempotency\_conflict bad\_request internal\_error

**message**

required

Human-readable explanation, safe to show to developers.

string

#### Example

```json
{
  "error": {
    "type": "validation_error"
  }
}
```