Wallet balance + most recent billing rows

Return the wallet’s current balance and most recent billing rows.

All resource types are included (compute, training, inference, traces, disks, sandboxes, images) — same source-of-truth Billing table the dashboard’s Billing History tab reads. Sorted by lastBilledAt desc.

GET /api/v1/billing/wallet

Wallet balance + most recent billing rows

cURL

curl --request GET \
  --url https://api.primeintellect.ai/api/v1/billing/wallet \
  --header 'Authorization: Bearer <token>'

200

{
  "wallet_id": "<string>",
  "balance_usd": 123,
  "currency": "<string>",
  "total_billings": 123,
  "recent_billings": [
    {
      "id": "<string>",
      "created_at": "2023-11-07T05:31:56Z",
      "updated_at": "2023-11-07T05:31:56Z",
      "amount_usd": 123,
      "currency": "<string>",
      "resource_type": "<string>",
      "last_billed_at": "2023-11-07T05:31:56Z",
      "resource_id": "<string>",
      "credits_covered_usd": 0
    }
  ],
  "team_id": "<string>",
  "credit_grants": [
    {
      "id": "<string>",
      "category": "<string>",
      "amount_usd": 123,
      "remaining_usd": 123,
      "currency": "<string>",
      "qualifier": "<string>",
      "label": "<string>",
      "expiresAt": "2023-11-07T05:31:56Z",
      "revokedAt": "2023-11-07T05:31:56Z"
    }
  ],
  "sandbox_credits_remaining_usd": 0,
  "credits_remaining_by_category": {}
}

Authorizations

Authorization · string · header · required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

limit · integer · default: 20

Number of recent billing rows to include (max 100).

Required range: 1 <= x <= 100

offset · integer · default: 0

Skip this many rows before returning. Lets callers page.

Required range: x >= 0

teamId · string | null

If provided, return the team's wallet (requires membership).

Response

200

application/json

Successful Response

Snapshot of a wallet's balance + most recent billing rows.

Drives prime wallet. One call returns everything an agent needs to audit the billing flow against a known training run. Credit grants are listed separately from balance_usd: they are category-scoped free credits consumed before balance, not wallet money.

wallet_id · string · required

balance_usd · number · required

Current balance in USD

currency · string · required

total_billings · integer · required

Total billing rows on the wallet (across all pages)

recent_billings · BillingEntry · object[] · required

Show child attributes

team_id · string | null

credit_grants · CreditGrantSummary · object[]

Active (non-revoked, non-expired, non-exhausted) grants on this wallet

Show child attributes

sandbox_credits_remaining_usd · number · default: 0

Sum of remaining sandbox-category grant credits in USD, snapshot

credits_remaining_by_category · Credits Remaining By Category · object

Remaining grant credits in USD per category (sandboxes, training, inference), snapshot

Show child attributes