Skip to Content
Docs
API referenceAnalytics

Usage against your limits

GET
/v1/usage

How much of its limits the workspace has used, read from the same counters that refuse a send. day is the last 24 hours and month the last 30 days, not the calendar month. A limit of null means no limit: metered plans have no monthly limit unless you set one. Reading this uses none of your quota.

Authorization

bearerAuth
headerAuthorizationBearer <token>

API key sent as Authorization: Bearer <key>. Looked up by SHA-256 hash (email_core::sha256_hex) against api_keys.hash; revoked keys and keys belonging to a suspended tenant are rejected. See the top-level Authentication section for permission levels.

Response Body

Usage.

application/json
  1. response
plan*string
metered*boolean

Sends past the included volume are billed, not refused.

day*
month*
rate_limit*
Example Request
curl -X GET 'https://api.emitd.com/v1/usage'
Example Response
{  "plan": "payg",  "metered": true,  "day": {    "used": 40,    "limit": 5000,    "remaining": 4960  },  "month": {    "used": 900,    "limit": null,    "remaining": null  },  "rate_limit": {    "limit": 100,    "remaining": 97,    "reset_seconds": 12  }}