sendsend.email
Sign inStart building

Retrieve usage

GET/v1/usage

This month’s sending against your allowance, the project’s daily limit, spending settings and sending health. Test-environment sends are not counted.

Required scope: emails:read

Example

curl -X GET 'https://api.sendsend.email/v1/usage' \
  -H "Authorization: Bearer $SENDSEND_API_KEY"

Response 200

{
  "period": "2026-10",
  "environment": "live",
  "allowance": 50000,
  "submitted": 1240,
  "reserved": 3,
  "hard_limit": 50000,
  "overage_enabled": false,
  "daily": {
    "limit": 1000000,
    "used": 87
  }
}

Errors

StatusCodeWhen
401unauthorizedThe API key is missing, invalid or revoked.
403forbiddenThe key does not have the scope this endpoint needs.

Every error has the same shape. See Errors.