GET /v1/account/usage

Returns quota usage and rate limit status for the current billing period.

GEThttps://api.mailbeam.dev/v1/account/usage

No request body required. Returns your current quota, usage, and plan details.

Response schema

Response fields

Name	Type	Required	Description
`plan`	string	required	Plan slug: free, starter, growth, pro, scale, enterprise.
`quota.limit`	integer	required	Max verifications for this billing period.
`quota.used`	integer	required	Verifications used so far this period.
`quota.remaining`	integer	required	Verifications remaining.
`quota.reset_at`	ISO 8601	required	When quota resets.

Response example

Response200 OK

{
  "plan": "growth",
  "period_start": "2025-01-01T00:00:00Z",
  "period_end": "2025-02-01T00:00:00Z",
  "quota": {
    "limit": 50000,
    "used": 12847,
    "remaining": 37153,
    "reset_at": "2025-02-01T00:00:00Z"
  },
  "rate_limit": {
    "per_second": 50
  },
  "overage": {
    "enabled": true,
    "rate_per_verification": 0.005,
    "current_overage_count": 0
  }
}