List credit transactions

GET/v1/billing/credits/transactions

List credit transactions.

Returns the organization's credit movements, newest first: purchases, plan allocations, consumption by PLATFORM keys, refunds, auto-recharges and withdrawals. Paginated with page (0-based, default 0) and page_size (default 50, at most 200; a larger value is lowered to 200).

Requires a member of the organization (any role), or an organization-scoped va_ key with the admin or member role. A workspace-scoped key is refused with 403.

Authorization

AuthorizationBearer va_
A platform API key (va_...), created under Settings > API keys. Scoped to an organization or one workspace, with an admin or member role. Used by the management API.

Query parameters

organizationstringrequired
the organization's slug
pageinteger<int32>
the page to return, starting at 0
page_sizeinteger<int32>
transactions per page, 1 to 200

Responses

200application/json

transactionsobject[]
The transactions on this page.
Child attributes
- idstring<uuid>
  The transaction's id (UUID).
- organizationstring
  The slug of the organization.
- typeenum<string>
  What moved the credit: PURCHASE, PLAN_ALLOCATION, CONSUMPTION (use by a PLATFORM key), REFUND, AUTO_RECHARGE or WITHDRAWAL.
  One of "PURCHASE", "PLAN_ALLOCATION", "CONSUMPTION", "REFUND", "AUTO_RECHARGE", "WITHDRAWAL"
- amount_usdnumber<double>
  The change to the balance, in USD: positive for credit added, negative for credit used or withdrawn.
- balance_afternumber<double>
  The balance after this transaction, in USD.
- descriptionstring
  A short description of the transaction.
- virtual_key_slugstring
  For CONSUMPTION, the PLATFORM key that used the credit; absent otherwise.
- created_atstring<date-time>
  When the transaction happened (ISO 8601 date-time).
totalinteger<int32>
The number of transactions across all pages.
pageinteger<int32>
This page's number, starting at 0.
page_sizeinteger<int32>
The most transactions per page.

VectorAxis is built by GK Labs, a member of NVIDIA Inception.