Skip to main content
GET
/
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,
    "bounced": 20,
    "opened": 1020,
    "clicked": 340,
    "unsubscribed": 5,
    "deliveryRate": 99.41,
    "bounceRate": 0.59,
    "openRate": 30.18,
    "clickRate": 10.06,
    "unsubscribeRate": 0.15
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.sequenzy.com/llms.txt

Use this file to discover all available pages before exploring further.

Returns aggregated email engagement metrics (sends, deliveries, bounces, opens, clicks, unsubscribes) across your entire account for a given time period. GET /api/v1/stats is kept as a backward-compatible alias for this endpoint.

​
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)
bouncednumberEmails that bounced
openednumberUnique opens (deduplicated by email send)
clickednumberUnique clicks (deduplicated by email send)
unsubscribednumberUnsubscribes in the period
deliveryRatenumberDelivery rate percentage (delivered / sent)
bounceRatenumberBounce rate percentage (bounced / 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,
    "bounced": 20,
    "opened": 1020,
    "clicked": 340,
    "unsubscribed": 5,
    "deliveryRate": 99.41,
    "bounceRate": 0.59,
    "openRate": 30.18,
    "clickRate": 10.06,
    "unsubscribeRate": 0.15
  }
}