Skip to main content
GET
Get KYC verification status (optional)

Authorizations

Authorization
string
header
required

Firebase ID token from /auth or any paid route, sent as a Bearer token: Authorization: Bearer <id_token> (the Bearer prefix is required).

Response

KYC verification status

user_id
string
kyc_verified
boolean

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_status
string | null

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

kyc_review_answer
string | null

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

kyc_last_reviewed_at
number | null

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