API ReferenceBillingGet subscription
GET/v2/billing/subscription

Get subscription

Your current plan, status, limits, credit balance, and trial eligibility.

Stablescope: read API KeyLearn about API scopes →

Request

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

Response

✓ 200 OK
200 response
{
  "subscription": {
    "plan": "pro",
    "billing": "monthly",
    "status": "active",
    "creditsBalance": 1840,
    "normalEmailsUsed": 412,
    "normalEmailsLimit": 64000,
    "aiEmailsUsed": 88,
    "aiEmailsLimit": 2500,
    "maxCampaigns": -1,
    "maxDomains": -1,
    "maxMailboxes": -1,
    "maxLeads": 75000,
    "maxTemplates": -1,
    "maxFollowUpSequences": -1,
    "aiClassifyPerMonth": -1,
    "autoAiReplyPerMonth": -1,
    "aiClassifyUsedThisMonth": 34,
    "autoAiReplyUsedThisMonth": 12,
    "dailySendingLimit": 2133,
    "periodStart": "2026-08-01T00:00:00Z",
    "periodEnd": "2026-09-01T00:00:00Z",
    "updatedAt": "2026-09-16T09:00:00Z",
    "autoRenew": true,
    "trialEligible": false
  }
}

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 →