Get KYC verification status (optional)
KYC is optional. Most endpoints (cards, gift cards, push-to-card, account balance, withdrawals) do not require verification. It is only needed for certain features such as Venmo/PayPal payouts via /send-payment, and may be used for additional controls in the future. If you are not using those features, you can ignore the verification endpoints entirely.
Returns the calling wallet’s cached KYC verification status. Use this as a free pre-flight check before paying for /send-payment: if kyc_verified is true the payout will go through. If it is false, don’t call /send-payment yet — that call would not send the payout (it returns kyc_required and a kyc_url), and the USDC you paid would just land in your account balance, recoverable with POST /withdraw. To start verification when not verified, call /get-kyc-link.
This reads the cached status kept up to date by the verification webhook; it does not start verification or return a verification link.
Requires a Bearer token from /auth or /get-card.
Authorizations
ID token from /auth or /get-card
Response
KYC verification status
Whether the wallet has completed identity verification. When true, /send-payment dispatches the payout. When false, /send-payment does not send: it returns kyc_required and the USDC paid lands in account balance (recoverable via POST /withdraw). Verify before calling /send-payment.
Latest review status from the verification provider, or null if never reviewed.
Latest review answer (e.g. GREEN for approved, RED for rejected), or null if never reviewed.
Epoch milliseconds of the last review, or null if never reviewed.