---
title: "Get KYC verification status (optional)"
method: GET
path: "/get-kyc-status"
tags: ["Verification (optional)"]
---

# Get KYC verification status (optional)

`GET /get-kyc-status`

## Request

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

**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`.

## Response `200`

KYC verification status

- object
  - `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, nullable: Latest review status from the verification provider, or null if never reviewed.
  - `kyc_review_answer` string, nullable: Latest review answer (e.g. GREEN for approved, RED for rejected), or null if never reviewed.
  - `kyc_last_reviewed_at` number, nullable: Epoch milliseconds of the last review, or null if never reviewed.

## Other responses

- `401`: Missing or invalid Bearer token
- `403`: Account is frozen. The response includes a `frozen_message` field explaining why.

---

[API](https://skmtc.dev/laso/apis/laso-finance-x402-api.md) · [All operations](https://skmtc.dev/laso/apis/laso-finance-x402-api/llms.txt) · [OpenAPI document](https://skmtc.dev/laso/apis/laso-finance-x402-api/revisions/ff8ce20b49ba?raw)