list_billing_history

The workspace's credit additions (purchases + grants), newest first.

The workspace's credit additions — credit-pack purchases and plan/admin grants — newest first. This is the "money trail" behind the get_credits totals. Usage debits are not here; see list_credit_usage.

Request

GET /api/v1/ops/credits/history?limit=50

Workspace-scoped — it takes no project parameter.

Parameter	In	Type	Required	Description
limit	query	integer	no	Max entries to return (default 50, max 200).

cURL

curl -H "Authorization: Bearer $TESTVIBE_API_KEY" \
  "$TESTVIBE_SERVER/api/v1/ops/credits/history?limit=20"

CLI

testvibe credits history --limit 20

MCP

Tool list_billing_history — { "limit": 20 } (optional).

Response

[
  {
    "createdUtc": "2026-06-17T15:20:08Z",
    "amount": 50000,
    "reason": "Credit pack (pack_large_50k)",
    "category": ""
  },
  {
    "createdUtc": "2026-06-01T00:00:04Z",
    "amount": 1500,
    "reason": "Plan grant",
    "category": ""
  }
]

Every amount is positive (a purchase or grant), newest first. category is empty for additions.

This is the credits in side of the ledger. For credits out — what consumed your credits — use list_credit_usage.

Errors

Always returns an array (empty when there are no additions). Authentication errors follow the standard conventions.