Account Usage

GET /v1/account/usage

Returns aggregated usage metrics across all channels for a recent time window, along with your plan's quotas for reference.

Authentication

Authorization: Bearer sk_live_YOUR_API_KEY

Query Parameters

Parameter	Type	Required	Description
period	string	No	Time window: 7d, 30d, or 90d. Defaults to 30d.

Request

cURL

curl "https://sendapi.co/v1/account/usage?period=30d" \
  -H "Authorization: Bearer sk_live_123456789"

Node.js

const usage = await client.account.getUsage({ period: '30d' });

Response

{
  "success": true,
  "data": {
    "period": "30d",
    "totals": {
      "sms_count": 312,
      "sms_cost": "7.80",
      "otp_sent": 84,
      "otp_verified": 78,
      "emails_sent": 8402,
      "wa_messages_in": 1203,
      "wa_messages_out": 4821,
      "ai_requests": 0
    },
    "limits": {
      "sms_quota": 500,
      "email_quota": 25000,
      "otp_quota": 1000,
      "ai_quota": 0
    },
    "daily": [
      {
        "date": "2026-03-09",
        "sms_count": 14,
        "sms_cost": "0.35",
        "otp_sent": 5,
        "emails_sent": 380
      }
    ]
  }
}

Field Reference

totals

Sum of activity across the selected period.

Field	Description
sms_count	SMS messages sent
sms_cost	Total SMS spend in USD (string with 2 decimals)
otp_sent	Number of OTP send requests
otp_verified	Number of OTPs the user successfully verified
emails_sent	Outbound emails
wa_messages_in	Inbound WhatsApp messages received across all sessions
wa_messages_out	Outbound WhatsApp messages sent
ai_requests	AI support-chat requests

limits

Your current plan's per-month caps. 0 means unlimited or not applicable. SMS, OTP, and Email reset on the first of each month.

daily

One entry per calendar day (most recent first). Useful for charting trends.