---
title: "Read one top-up (the Lightning waiting client's poll)"
method: GET
path: "/orgs/v1/{org_id}/checkouts/{topup_id}"
tags: ["Billing"]
---

# Read one top-up (the Lightning waiting client's poll)

`GET /orgs/v1/{org_id}/checkouts/{topup_id}`

## Request

- Base URL: `https://api.run402.com`
- URL: `https://api.run402.com/orgs/v1/{org_id}/checkouts/{topup_id}`
- Auth: one of:
  - API key in header `SIGN-IN-WITH-X`
  - HTTP bearer
  - API key in header `x-admin-key`

lightning-cash-topup: the stored state of a top-up — pending, paid, paid_late (paid after the invoice expired; still credited), or expired. Authorized like the organization's billing read: any active member, or a grant key for one of its projects. An unauthorized caller receives the same not-found as a nonexistent id. Never carries the provider's credential or identifiers.

## Path parameters

- `org_id` string, uuid, required
- `topup_id` string, uuid, required

## Response `200`

The top-up

- LightningTopup: A Lightning cash top-up (lightning-cash-topup). The USD value is a QUOTE fixed at mint from `quoted_rate` and is what settlement credits. Never carries the provider's credential.
  - `org_id` string, uuid, required
  - `product` 'balance_topup', required
  - `rail` 'lightning', required
  - `topup_id` string, uuid, required
  - `bolt11` string, nullable, required: The payable invoice, verbatim (a standards-owned wire artifact).
  - `payment_hash` string, nullable, required
  - `amount_sats` integer, nullable, required
  - `amount_usd_micros` integer, required: The quoted USD value in micro-dollars; credited as-is on settlement.
  - `usd_value_is_quote` true, required
  - `quoted_rate` object, nullable: usd_per_btc, source, observed_at, amount_sats
  - `invoice_expires_at` string, date-time, nullable, required
  - `status` 'pending' | 'paid' | 'paid_late' | 'expired', required
  - `paid_at` string, date-time, nullable, required
  - `credited_ledger_id` string, uuid, nullable, required
  - `created_at` string, date-time, nullable
  - `next_actions` object[], required

## Other responses

- `404`: LIGHTNING_TOPUP_NOT_FOUND — no such top-up in this organization (also the unauthorized answer)

---

[API](https://skmtc.dev/run402/apis/run402-api.md) · [All operations](https://skmtc.dev/run402/apis/run402-api/llms.txt) · [OpenAPI document](https://skmtc.dev/run402/apis/run402-api/revisions/893607557f50?raw)