Monthly usage and quota
GET
/v1/usage
const url = 'https://api.mailerdash.com/v1/usage?month=2026-04';const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request GET \ --url 'https://api.mailerdash.com/v1/usage?month=2026-04' \ --header 'Authorization: Bearer <token>'Returns sent count and quota for the current month. Admin sees all keys; regular key sees only its own.
Authorizations
Sección titulada «Authorizations »Parameters
Sección titulada « Parameters »Query Parameters
Sección titulada «Query Parameters » month
string
Month to query in YYYY-MM format (default: current month)
Example
2026-04Responses
Sección titulada « Responses »Usage summary
Media type application/json
One of:
object
key_id
string
label
string
month
string
sent
integer
monthly_quota
integer
remaining
integer
Admin — usage de todas las keys
Array<object>
object
key_id
string
label
string
month
string
sent
integer
monthly_quota
integer
remaining
integer
Example generated
{ "key_id": "example", "label": "example", "month": "example", "sent": 1, "monthly_quota": 1, "remaining": 1}Unauthorized