Samva
DashboardAPI
ChannelsPlatformDevelopersEmail templatesIntegrationsAPI Reference
Analytics

Get message delivery metrics

Get message delivery metrics. View request and response details for this Samva email API endpoint.

GET
/v1/analytics/delivery-metrics

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.

Authorization

apiKey
x-api-key<token>

In: header

Query Parameters

startDate?|null
endDate?|null
channel?|null

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/v1/analytics/delivery-metrics"
{  "deliveredRate": 0,  "failedRate": 0,  "pendingRate": 0,  "avgDeliveryTimeMs": 0}

Get channel performance analytics

Returns aggregate delivery metrics plus unique-message email Open and Click rates over the selected date range.

Get sending-number distribution

Returns outbound message volume grouped by the first three characters of the sending phone number, most-used first, up to twenty groups.