Account Usage

GET /v1/account/usage

Returns your API usage metrics for the current billing period, broken down by channel and compared against your plan's quotas.

Authentication

Authorization: Bearer sk_live_YOUR_API_KEY

Request

cURL

curl https://sendapi.co/v1/account/usage \
  -H "Authorization: Bearer sk_live_123456789"

Node.js

const usage = await client.account.getUsage();

Response

{
  "plan": "Pro",
  "billing_period": {
    "starts_at": "2026-03-01T00:00:00Z",
    "ends_at": "2026-03-31T23:59:59Z"
  },
  "usage": {
    "whatsapp_messages": {
      "sent": 4821,
      "received": 1203,
      "quota": 5000,
      "percentage": 96.4
    },
    "sms": {
      "sent": 312,
      "cost_usd": 12.48,
      "quota": null
    },
    "emails": {
      "sent": 8402,
      "quota": 50000,
      "percentage": 16.8
    },
    "whatsapp_sessions": {
      "active": 2,
      "quota": 5
    }
  },
  "daily_breakdown": [
    {
      "date": "2026-03-09",
      "whatsapp_sent": 210,
      "sms_sent": 14,
      "emails_sent": 380
    }
  ]
}

Query Parameters

Parameter	Type	Required	Description
from_date	string	No	ISO 8601 date. Defaults to start of current billing period.
to_date	string	No	ISO 8601 date. Defaults to today.
granularity	string	No	daily (default) or monthly.