list_billing_history
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
- CLI
- MCP
curl -H "Authorization: Bearer $TESTVIBE_API_KEY" \
"$TESTVIBE_SERVER/api/v1/ops/credits/history?limit=20"
testvibe credits history --limit 20
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.
info
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.