Account

Read your account, credit balance, subscription, and credit usage history.

Read-only endpoints for your account and credits.

Get account info

GET /v1/account

Returns your profile, current credit balance, and subscription.

{
  "data": {
    "id": "uuid",
    "email": "user@example.com",
    "name": "User Name",
    "avatar_url": "...",
    "credits": { "balance": 247 },
    "subscription": {
      "plan": "pro",
      "status": "active",
      "current_period_end": "2026-04-29T..."
    },
    "created_at": "..."
  }
}

subscription is null for free users.

Credit usage history

GET /v1/account/usage

Returns credit transactions with cursor pagination. Each entry has:

Field	Description
`amount`	Negative for usage, positive for refunds/purchases
`type`	Transaction type
`description`	Human-readable description
`created_at`	Timestamp