Skip to main content
GET
/
kyc-status
Get KYC status
curl --request GET \
  --url https://aarwcjjzhlmkgdwrisyt.supabase.co/functions/v1/kyc-status \
  --header 'Authorization: Bearer <token>'
{
  "success": true,
  "status": 200,
  "data": {
    "status": "verified",
    "account_type": "individual",
    "current_tier": {
      "level": 2,
      "name": "Tier 2 — Standard",
      "single_credit_limit": 5000000,
      "daily_credit_limit": 10000000,
      "single_debit_limit": 5000000,
      "daily_debit_limit": 10000000
    },
    "checks": [
      {
        "check_type": "bvn_lookup",
        "provider": "youverify",
        "status": "verified",
        "verified_at": "2026-03-01T10:00:00Z"
      },
      {
        "check_type": "liveness",
        "provider": "sumsub",
        "status": "verified",
        "verified_at": "2026-03-01T10:05:00Z"
      }
    ],
    "pending_edd": null
  }
}

Authorizations

Authorization
string
header
required

JWT access token obtained from /auth-verify (login context) or /auth-signup. Set the bearer_token environment variable in your API client to apply it globally.

Response

KYC status returned

success
boolean
Example:

true

status
integer
Example:

200

data
object