Retrieve usage · Docs

GEThttps://api.vaelor.chat/v1/usage

Returns your credit balance for the current 12-hour window, the live price list, and an itemized log of every charge. It's the same data shown on the Usage page.

Query parameters#

cursorstring

The activity.nextCursor value from a previous response. Returns the next page of activity.

Response#

planenum

free, basic, plus, pro or max.

allowanceinteger

Plan credits per 12-hour window.

dailyAllowanceinteger

Plan credits per UTC day.

consumedinteger

Plan credits spent in this window.

reservedinteger

Credits held by requests that are still running.

renewableRemaininginteger

Plan credits left in this window.

permanentRemaininginteger

Non-expiring credits left.

remaininginteger

Total spendable credits.

windowStartstring

Start of the current window, in ISO 8601.

nextRefreshAtstring

When plan credits next refresh.

pricingobject

The live price list: chat token rates per tier, images per quality, music.creditsPerSecond, and tools.

activityobject

records, the charges newest first, and nextCursor, which is null on the last page. Each record has a feature, model, status (pending, settled or refunded), chargedCredits, token counts and createdAt.

Example#

curl https://api.vaelor.chat/v1/usage \
  -H "Authorization: Bearer $VAELOR_API_KEY"

const usage = await fetch('https://api.vaelor.chat/v1/usage', {
  headers: { Authorization: `Bearer ${process.env.VAELOR_API_KEY}` }
}).then((response) => response.json())

console.log(`${usage.remaining} credits left, refresh at ${usage.nextRefreshAt}`)

usage = requests.get(
    "https://api.vaelor.chat/v1/usage",
    headers={"Authorization": f"Bearer {os.environ['VAELOR_API_KEY']}"},
).json()

Response200

JSON

{
  "plan": "plus",
  "allowance": 300,
  "dailyAllowance": 600,
  "consumed": 84,
  "reserved": 1,
  "renewableRemaining": 215,
  "permanentRemaining": 1250,
  "remaining": 1465,
  "windowStart": "2026-10-20T00:00:00.000Z",
  "nextRefreshAt": "2026-10-20T12:00:00.000Z",
  "pricing": {
    "version": 7,
    "chat": {
      "flash": { "input": 8000, "output": 2700 },
      "medium": { "input": 6500, "output": 2000 },
      "high": { "input": 900, "output": 200 }
    },
    "images": { "flash": 20, "high": 60 },
    "music": { "creditsPerSecond": 1 },
    "tools": { "web-search": 4, "page-read": 2, "document-parse-unit": 2, "uncensored-step": 0 }
  },
  "activity": {
    "records": [
      {
        "id": "u_01JAZK3M9V2Q",
        "feature": "chat",
        "model": "medium",
        "status": "settled",
        "chargedCredits": 2,
        "inputTokens": 5210,
        "outputTokens": 1388,
        "createdAt": "2026-10-20T09:40:12.000Z"
      }
    ],
    "nextCursor": "2026-10-20T09:40:12.000Z"
  }
}