Skip to main content
GET
The Usage API is currently in private beta and only available to a limited number of users. The response shape might change before GA. Get in touch if you’re interested in testing this feature.Once you have access, upgrade your Resend SDK to use the methods on this page:
Node.js

Response Fields

string
Always usage.
string
When this usage snapshot was generated.
object
Email sending and receiving quota, broken down by day and month.
object
Shaped as { used, limit }.
object
Shaped as { used, limit }. limit is null once the team has an active contacts subscription — segment caps only apply to the free tier.
object
Shaped as { used, limit }. limit is always null — broadcasts have no cap.
object
Shaped as { used, limit, next_increase_at }. next_increase_at is null until the team’s first AI credit use in the current rolling window; once credits are used, it’s when the oldest usage ages out and frees up quota.
object
Shaped as { used, limit, resets_at }.
object
Shaped as { used, limit }. limit is null when the plan has no domain cap.
object
The team’s API rate limit, shaped as { limit, duration }. duration is a string like "1000ms".