---
title: "List immutable billing entries"
method: GET
path: "/v1/billing/ledger"
---

# List immutable billing entries

`GET /v1/billing/ledger`

## Request

- Base URL: `https://docs.greatwait.dev` (the document declares no server; this is the origin it was published from)
- URL: `https://docs.greatwait.dev/v1/billing/ledger`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer and API key in header `Greatwait-Environment` and API key in header `Greatwait-Project`

Lists the verified principal's organization ledger in immutable sequence order. Each entry is one exact signed microdollar fact with safe attempt, lot, payment-operation and event references. Raw callback data, card data, internal causal keys and ledger detail have no field in the response. The opaque cursor is bound to the principal's organization, project and environment and cannot widen authority.

## Query parameters

- `cursor` string
- `limit` integer

## Response `200`

List immutable billing entries

- object
  - `data` object[], required
    - `amount` object, required
      - `currency` 'USD', required
      - `microdollars` string, required
      - `scale` 6, required
    - `kind` 'credit_granted' | 'credit_reversed' | 'attempt_debited' | 'attempt_released' | 'shadow_attempt_debited' | 'shadow_attempt_released' | 'late_evidence_waived' | 'policy_installed' | 'budget_policy_updated' | 'budget_threshold_reached' | 'budget_exhausted' | 'budget_recovered' | 'automatic_charge_ceiling_updated' | 'payment_reserved' | 'payment_submitted' | 'payment_pending' | 'payment_paid' | 'payment_failed' | 'payment_canceled' | 'payment_authentication_required' | 'payment_action_required' | 'payment_refunded' | 'payment_disputed' | 'payment_reversed' | 'payment_dispute_restored' | 'refund_requested' | 'payment_refund_canceled' | 'automatic_top_up_cap_reached' | 'automatic_charge_threshold_reached' | 'automatic_charge_threshold_recovered' | 'low_credit_reached' | 'low_credit_recovered' | 'notification_settings_updated' | 'service_blocked' | 'service_restored', required
    - `note` 'provider-details-attached': Present when an entry moved no money despite its kind. provider-details-attached: the provider reported details of a payment already recorded; the amount is zero.
    - `period` string
    - `recordedAt` string, required
    - `reference` object, required
      - `attempt` string
      - `creditLot` string
      - `event` string, required
      - `paymentOperation` string
    - `sequence` string, required
  - `freshness` object, required
    - `kind` 'authoritative', required
  - `nextCursor` string

## Other responses

- `400`: Problem document. Possible codes at this status: invalid_request.
- `401`: Problem document. Possible codes at this status: authentication_required, credential_expired, credential_revoked.
- `403`: Problem document. Possible codes at this status: scope_missing.
- `409`: Problem document. Possible codes at this status: project_archived.
- `429`: Problem document. Possible codes at this status: rate_limited.
- `503`: Problem document. Possible codes at this status: capability_not_configured, service_unavailable.

---

[API](https://skmtc.dev/greatwait/apis/greatwait-v1.md) · [All operations](https://skmtc.dev/greatwait/apis/greatwait-v1/llms.txt) · [OpenAPI document](https://skmtc.dev/greatwait/apis/greatwait-v1/revisions/6855bce23e72?raw)