---
title: "Get message delivery metrics"
method: GET
path: "/v1/analytics/delivery-metrics"
tags: ["Analytics"]
---

# Get message delivery metrics

`GET /v1/analytics/delivery-metrics`

## Request

- Base URL: `https://api.samva.dev`
- URL: `https://api.samva.dev/v1/analytics/delivery-metrics`
- Auth: API key in header `x-api-key`

Returns delivered, failed, and pending rates plus average delivery time for the outbound messages accepted in the selected date range, optionally filtered by channel. Every accepted message falls into exactly one of the three, so they always sum to 100%: a complaint counts as delivered because the message arrived, a bounce counts as failed, and anything the provider has not resolved yet counts as pending. Mail your organization received is not rated here.

## Query parameters

- `after` string, nullable
- `before` string, nullable
- `channel` 'email', nullable

## Response `200`

Success

- object
  - `deliveredRate` number, required
  - `failedRate` number, required
  - `pendingRate` number, required
  - `avgDeliveryTimeMs` number, required

## Other responses

- `400`: AnalyticsQueryError
- `401`: UnauthorizedError
- `403`: ForbiddenError
- `422`: ValidationError
- `500`: InternalError
- `504`: GatewayTimeoutError

---

[API](https://skmtc.dev/samva/apis/samva-api.md) · [All operations](https://skmtc.dev/samva/apis/samva-api/llms.txt) · [OpenAPI document](https://skmtc.dev/samva/apis/samva-api/revisions/a99408542cc3?raw)