Sign in

v11

latestOpenAPI 3.1.0raw.githubusercontent.com2026-08-0112893437.0 KB
Guest Wallets

Get guest wallet and payment status

Poll after Stripe payment. Use usable to decide whether paid reads can run. An active wallet can remain usable while a top-up is pending. A new wallet becomes usable only after verified webhook fulfillment. Send the guest key as Authorization: Bearer.

get/guest-wallets/status

Response

Guest wallet status without exposing the API key.

balancestring required
poll_after_seconds2 nullable required

Polling delay while payment is pending. Null means stop.

scope'paid_reads' required
status'active' | 'pending' | 'expired' | 'failed' | 'frozen' | 'closed' required

Combined wallet and pending-checkout state. A pending top-up can coexist with usable true. Terminal expired or failed states require a new guest wallet.

usableboolean required

Authoritative paid-read readiness. Use instead of status.

wallet_idstring required

Example response

{
  "balance": "66666",
  "latest_purchase": {
    "amount": {
      "amount_minor": 1000
    },
    "credits": "66666",
    "expires_at": "2026-07-13T13:00:00.000Z",
    "purchase_id": "gp_example",
    "status": "paid"
  },
  "poll_after_seconds": 2,
  "status": "active",
  "top_up": {
    "method": "POST",
    "path": "/api/v1/guest-wallets/topups"
  },
  "usable": true,
  "wallet_id": "gw_example"
}