Skip to content
Log in
Developer API
Get your keyGet a key

Reference · Account

GET/account

The account: credits, plan and the studios that are on

The person's Vessero account: how many credits they have and how they split (from their plan, bought, given until a date), their plan and when its credits refill, whether buying is open — and, without a plan, how many one-off buys are left and when the next opens — and which studios are switched on for them. Use it before spending, to say what something will leave them with, or when a create tool says there are not enough credits. Free.

Key needs
account:read · See your account
Spends
Nothing
Answers
Data
Request
curl https://vessero.com/api/v1/account \
  -H "Authorization: Bearer $VESSERO_API_KEY"
Response200 OK
{
  "email": "ada@okafor.studio",
  "credits": {
    "total": 840,
    "fromPlan": 600,
    "purchased": 240,
    "withAnEnd": [],
    "unmetered": false
  },
  "plan": {
    "name": "Pro",
    "status": "active",
    "creditsPerPeriod": 1200,
    "refillsAt": "2026-11-21T09:12:00.000Z",
    "endsAtPeriodEnd": false
  },
  "purchasesOpen": true,
  "oneOffBuys": null,
  "addCreditsUrl": "https://vessero.com/pricing",
  "studios": [
    {
      "id": "video",
      "name": "Video",
      "on": true,
      "url": "https://vessero.com/video",
      "tools": [
        "POST /api/v1/videos"
      ]
    }
  ]
}

Answers

  • 200okThe answer, as data.
  • 404not_foundNot found on this account.
  • 429rate_limitedToo many calls this minute: see Retry-After.
Next in AccountPOST/codes/redeem