Skip to main content
GET https://xquik.com/api/v1/guest-wallets/status Poll this endpoint after the user completes hosted checkout. While the wallet is pending, the guest key can authenticate this status route. It cannot call paid read routes until Xquik verifies payment.
Wait at least poll_after_seconds before polling again. Continue while it is non-null, then stop. Use usable to decide whether paid reads can run. An active wallet can remain usable while a top-up is pending.

Headers

Response

Interpret the result

Use these fields together.latest_purchase.status describes only the latest purchase. Use the top-level usable field for paid-read access.
Use usable to decide whether the key can call paid reads.The response sends Cache-Control: no-store, private and never returns the guest key.

Response examples

200 example

  • 401 { "error": "unauthenticated", "message": "Authentication required. Provide a valid API key or bearer token." }
  • 429 { "error": "rate_limited", "message": "Try again later." }