Skip to content
VaartixVaartix Docs

Get sending metrics

GET
/metrics
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

Section titled “Authorizations”

Parameters

Section titled “Parameters”

Query Parameters

Section titled “Query Parameters”
days
integer
default: 15 >= 1 <= 90

Responses

Section titled “Responses”

200

Section titled “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 

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

401

Section titled “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 

{
  "error": {
    "type": "validation_error"
  }
}

403

Section titled “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 

{
  "error": {
    "type": "validation_error"
  }
}