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.
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.- 200 OK
- 401 Unauthenticated
- 429 Rate limited
usable to decide whether the key can call paid reads.The response sends Cache-Control: no-store, private and never returns the guest key.Related. Guest wallet guide · Create guest wallet · Top up guest wallet
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." }