Skip to main content
GET
https://api.sequenzy.com
/
api
/
v1
/
metrics
Get Account Metrics
curl --request GET \
  --url https://api.sequenzy.com/api/v1/metrics \
  --header 'Authorization: Bearer <token>'
{
  "success": true,
  "period": "7d",
  "stats": {
    "sent": 3400,
    "delivered": 3380,
    "opened": 1020,
    "clicked": 340,
    "unsubscribed": 5,
    "deliveryRate": 99.41,
    "openRate": 30.18,
    "clickRate": 10.06,
    "unsubscribeRate": 0.15
  }
}
Returns aggregated email engagement metrics (sends, deliveries, opens, clicks, unsubscribes) across your entire account for a given time period.

Query Parameters

period
string
Sliding time window. One of: 1h, 24h, 7d, 30d, 90d. Ignored when start and end are provided.
start
string
Start of custom time range (ISO 8601, e.g. 2026-02-01T00:00:00Z). Must be used with end.
end
string
End of custom time range (ISO 8601, e.g. 2026-02-14T00:00:00Z). Must be used with start. Max range: 90 days.

Response Fields

FieldTypeDescription
sentnumberEmails sent in the period
deliverednumberEmails delivered (capped at sent)
openednumberUnique opens (deduplicated by email send)
clickednumberUnique clicks (deduplicated by email send)
unsubscribednumberUnsubscribes in the period
deliveryRatenumberDelivery rate percentage (delivered / sent)
openRatenumberOpen rate percentage (opens / delivered)
clickRatenumberClick rate percentage (clicks / delivered)
unsubscribeRatenumberUnsubscribe rate percentage (unsubscribes / delivered)

Common Queries

How many emails did we send in the last 7 days?

curl "https://api.sequenzy.com/api/v1/metrics?period=7d" \
 -H "Authorization: Bearer YOUR_API_KEY"
Check the sent field in the response.

What’s our overall open rate this month?

curl "https://api.sequenzy.com/api/v1/metrics?start=2026-02-01T00:00:00Z&end=2026-02-28T00:00:00Z" \
 -H "Authorization: Bearer YOUR_API_KEY"
Check the openRate field — this is calculated as opens / delivered.

How are we doing in the last 24 hours?

curl "https://api.sequenzy.com/api/v1/metrics?period=24h" \
 -H "Authorization: Bearer YOUR_API_KEY"
Useful for daily monitoring dashboards or Slack alerts.

Sync daily metrics to our data warehouse

Use fixed time ranges to pull yesterday’s metrics on a cron schedule:
curl "https://api.sequenzy.com/api/v1/metrics?start=2026-02-13T00:00:00Z&end=2026-02-14T00:00:00Z" \
 -H "Authorization: Bearer YOUR_API_KEY"
Fixed ranges are idempotent — safe to retry without double-counting.

Responses

{
  "success": true,
  "period": "7d",
  "stats": {
    "sent": 3400,
    "delivered": 3380,
    "opened": 1020,
    "clicked": 340,
    "unsubscribed": 5,
    "deliveryRate": 99.41,
    "openRate": 30.18,
    "clickRate": 10.06,
    "unsubscribeRate": 0.15
  }
}