GET/v2/billing/usage

Get usage

Current usage counts against plan limits, plus both credit balances. A plain read with no side effects — unlike Get subscription, this never starts a trial or syncs plan limits.

Stablescope: read API KeyLearn about API scopes →

Request

AuthorizationBearer YOUR_API_KEY
curl "https://api.stynar.com/v2/billing/usage" \
  -H "Authorization: Bearer esk_your_key_here"

Response

✓ 200 OK
200 response
{
  "usage": {
    "campaignsCount": 6,
    "domainsCount": 2,
    "mailboxesCount": 4,
    "leadsCount": 12480,
    "templatesCount": 9,
    "dailySentCount": 210,
    "dailySentDate": "2026-08-16",
    "creditsBalance": 1840,
    "topupCreditsBalance": 500
  }
}

Response fields

Errors

StatusCodeMeaning
✕ 401 UnauthorizedUNAUTHORIZEDMissing, malformed, unknown, revoked, or expired key.
✕ 403 ForbiddenAPI_ACCESS_DISABLEDAPI access is turned off for your account.
✕ 403 ForbiddenINSUFFICIENT_SCOPEThe key doesn't have the scope this endpoint requires.
✕ 404 Not FoundNOT_FOUNDUnknown route, or a resource that doesn't exist / isn't yours.
✕ 409 ConflictCONFLICTThe action can't be applied to the resource's current state.
✕ 429 Too Many RequestsRATE_LIMIT_EXCEEDEDPer-minute or per-second limit hit.
✕ 429 Too Many RequestsQUOTA_EXCEEDEDMonthly quota exhausted.
✕ 500 Internal Server ErrorINTERNAL_ERRORSomething broke on Stynar's end.
Full error reference →