Docs
/v1/credits · Credits

Credits API

Returns the same monthly credit totals shown on the XBeast dashboard. Credits reset at the start of each billing cycle (the 1st of the month for users without a subscription). Publishing a post to X costs 1 credit (plus 8 if it contains a URL), charged after a successful send.
GET/api/v1/credits
{
  "credits_used": 120,
  "credits_available": 880,
  "credits_limit": 1000,
  "resets_at": "2026-10-15T00:00:00.000Z"
}
FieldTypeRequiredDescription
credits_usednumber—Credits consumed this billing cycle.
credits_availablenumber—Remaining credits (limit minus used, never below 0).
credits_limitnumber—Plan monthly allowance.
resets_atstring (ISO 8601)—Start of the next billing cycle, when usage counters reset.
curl
curl "https://xbeast.io/api/v1/credits" \
  -H "Authorization: Bearer xb_live_YOUR_KEY"