Skip to main content

​
GET /credits/balance

This endpoint returns the authenticated user’s current credit balance and usage statistics. Requires session-based authentication (JWT access token).

​
Response

​
balance
number
The user’s current available credit balance.
​
totalPurchased
number
Total credits purchased over the account lifetime.
​
totalUsed
number
Total credits used over the account lifetime.
​
recentTransactions
array
Array of recent credit transactions.
curl -X GET https://api.llmgenerator.com/api/v1/credits/balance \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

{
  "balance": 450,
  "totalPurchased": 1000,
  "totalUsed": 550,
  "recentTransactions": [
    {
      "id": "txn_abc123",
      "type": "purchase",
      "amount": 500,
      "description": "Purchased Pro Pack",
      "createdAt": "2026-01-15T10:00:00Z"
    },
    {
      "id": "txn_def456",
      "type": "usage",
      "amount": -50,
      "description": "API LLMs.txt generation (enhanced) for example.com (25 URLs)",
      "createdAt": "2026-01-20T14:30:00Z"
    }
  ]
}