Get ledger

Append-only history of every wallet movement.

GET /v1/billing/ledger

All movements

curl https://gpuoutlet.ai/v1/billing/ledger --cookie "sid=$SID"

200 OK

{
  "entries": [
    {
      "id": "led_01H...",
      "type": "rental_charge",
      "amountCents": -47,
      "balanceAfterCents": 4953,
      "createdAt": "2026-06-07T08:15:22Z",
      "rentalId": "rent_01H..."
    },
    {
      "id": "led_01H...",
      "type": "stripe_topup",
      "amountCents": 5000,
      "balanceAfterCents": 5000,
      "createdAt": "2026-06-07T08:14:22Z",
      "stripeChargeId": "ch_3Q..."
    }
  ],
  "balanceCents": 4953,
  "nextCursor": null
}

cursor · string

Pagination cursor.

pageSize · number · default: "50"

Max 200.

type · string

Filter to one of: stripe_topup, rental_charge, refund, auto_topup, adjustment.

entries · array

Ledger entries, newest first.

balanceCents · number

Current wallet total (same as totalCents from /v1/billing/balance).

nextCursor · string | null

All movements

curl https://gpuoutlet.ai/v1/billing/ledger --cookie "sid=$SID"

200 OK

{
  "entries": [
    {
      "id": "led_01H...",
      "type": "rental_charge",
      "amountCents": -47,
      "balanceAfterCents": 4953,
      "createdAt": "2026-06-07T08:15:22Z",
      "rentalId": "rent_01H..."
    },
    {
      "id": "led_01H...",
      "type": "stripe_topup",
      "amountCents": 5000,
      "balanceAfterCents": 5000,
      "createdAt": "2026-06-07T08:14:22Z",
      "stripeChargeId": "ch_3Q..."
    }
  ],
  "balanceCents": 4953,
  "nextCursor": null
}

Entry types

Type	amountCents	Trigger
stripe_topup	positive	One-off Stripe Checkout completed
auto_topup	positive	Auto-topup threshold tripped + Stripe charge succeeded
rental_charge	negative	Metering tick, ~1/second per running rental
refund	positive	Failed pod, < 60s crash, or manual refund
adjustment	positive or negative	Manual ops adjustment (rare; we’ll email you)

balanceAfterCents is the wallet total immediately after this entry was applied. Helpful for reconciling — entries[i].balanceAfterCents should equal entries[i].amountCents + entries[i+1].balanceAfterCents.

Tax / export

We don’t generate invoices automatically. To export your full ledger as CSV for accounting:

curl 'https://gpuoutlet.ai/v1/billing/ledger?pageSize=200' --cookie "sid=$SID" | \
  jq -r '.entries[] | [.createdAt, .type, .amountCents, .balanceAfterCents] | @csv' \
  > gpuoutlet-ledger.csv

Paginate via nextCursor if your account has more than 200 entries.