Verification (optional)

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.

get/get-kyc-status

Request

  • Base URL: https://laso.finance
  • URL: https://laso.finance/get-kyc-status
  • Auth: API key in header Authorization

Response

KYC verification status

user_idstring
kyc_verifiedboolean

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.

kyc_review_statusstring nullable

Latest review status from the verification provider, or null if never reviewed.

kyc_review_answerstring nullable

Latest review answer (e.g. GREEN for approved, RED for rejected), or null if never reviewed.

kyc_last_reviewed_atnumber nullable

Epoch milliseconds of the last review, or null if never reviewed.

Changes

No recorded changes to this operation across all 3 revisions of this API.