Skip to main content

Emails Sent

Track monthly volume

Delivery Rate

Monitor success rates

Daily Stats

Historical breakdown

Rate Limits

Plan-based limits

​
Get Usage Statistics

GET/v1/usage
Retrieve your current usage statistics including emails sent, delivery rates, and rate limits for the current billing period.

​
Query Parameters

​
period
string
default:"30d"
Time period for daily stats: 7d, 30d, 90d

​
Request

curl https://www.unosend.co/api/v1/usage?period=30d \
  -H "Authorization: Bearer un_your_api_key"

​
Response

200 OK
{
  "success": true,
  "data": {
    "plan": "50k",
    "rate_limit": {
      "requests_per_minute": 500,
      "requests_per_hour": 20000,
      "requests_per_day": 60000
    },
    "usage": {
      "emails_sent": 2847,
      "emails_limit": 60000,
      "emails_delivered": 2801,
      "emails_bounced": 23,
      "period_start": "2026-02-01T00:00:00.000Z",
      "period_end": "2026-02-28T00:00:00.000Z"
    },
    "daily_stats": {
      "today": 156,
      "peak": 423,
      "average": 95,
      "history": [
        { "date": "2026-02-01", "count": 89 },
        { "date": "2026-02-02", "count": 156 },
        { "date": "2026-02-03", "count": 423 }
      ]
    }
  }
}

​
Response Fields

FieldTypeDescription
planstringCurrent plan (free, 10k, 25k, 50k, 100k, 200k, 300k, 400k, 600k, 800k, 1m, enterprise)
rate_limit.requests_per_minutenumberMaximum API requests per minute for your plan
rate_limit.requests_per_hournumberMaximum API requests per hour for your plan
rate_limit.requests_per_daynumberMaximum API requests per day for your plan
usage.emails_sentnumberTotal emails sent this billing period
usage.emails_limitnumberMaximum emails allowed for your plan
usage.emails_deliverednumberSuccessfully delivered emails
usage.emails_bouncednumberBounced or failed emails
daily_stats.todaynumberEmails sent today
daily_stats.peaknumberHighest daily count in the period
daily_stats.averagenumberAverage daily count in the period
daily_stats.historyarrayDaily breakdown with date and count

​
Common Use Cases

​
Check if approaching limit

# Get usage and check percentage used
curl https://www.unosend.co/api/v1/usage \
  -H "Authorization: Bearer un_your_api_key" | \
  jq '.data.usage | (.emails_sent / .emails_limit * 100) | floor'

​
Get last 7 days stats

curl "https://www.unosend.co/api/v1/usage?period=7d" \
  -H "Authorization: Bearer un_your_api_key"

​
Monitor delivery rate

# Calculate delivery rate percentage
curl https://www.unosend.co/api/v1/usage \
  -H "Authorization: Bearer un_your_api_key" | \
  jq '.data.usage | (.emails_delivered / .emails_sent * 100) | floor'

​
Rate Limits by Plan

PlanRequests/MinuteRequests/HourRequests/Day
Free10100500
10K2005,00015,000
25K30010,00030,000
60K50020,00060,000
100K80040,000120,000
200K1,00060,000250,000
300K1,50080,000350,000
400K2,000100,000500,000
600K3,000150,000700,000
800K4,000200,000900,000
1M5,000250,0001,200,000
Enterprise10,000500,0002,000,000
Exceeding rate limits will result in 429 Too Many Requests errors. Implement exponential backoff in your applications.