Skip to main content

​
Endpoint

GET /v1/billing/transactions
Authorization: Bearer <JWT>
Returns paginated credit transaction history for the authenticated developer.

​
Query Parameters

ParamTypeDefaultDescription
pagenumber1Page number
limitnumber20Items per page (max 100)
typestring—Filter by type: topup, deduction, refund, starter, admin_grant, topup_pending, topup_completed

​
Response

{
  "transactions": [
    {
      "id": "tx-uuid",
      "type": "topup",
      "amount": 1000,
      "balanceAfter": 1850,
      "description": "Top-up: 1000 credits ($10.00 USD, completed)",
      "createdAt": "2026-03-25T10:00:00Z"
    },
    {
      "id": "tx-uuid-2",
      "type": "deduction",
      "amount": -5,
      "balanceAfter": 1845,
      "description": "memory.write (POST /v1/memory)",
      "createdAt": "2026-03-25T10:05:00Z"
    }
  ],
  "total": 42,
  "page": 1,
  "limit": 20
}

​
Transaction Types

TypeDirectionDescription
topup+Credits purchased via Tender payment
topup_pending0Payment intent created, awaiting completion
topup_completed0Pending intent marked as completed after crediting
topup_failed0Payment verification failed
starter+Free credits on signup
admin_grant+Credits granted by an admin
refund+Credits refunded after a server error (5xx) or input validation failure (400, 413, 422)
deduction−Credits consumed by an API operation

​
Errors

StatusReason
401Missing or invalid JWT token