Get KYC Status

Check KYC verification status for a user

GET

texttext

/api/v2/kyc/status

Retrieves the current KYC verification status and level for a user.

Query Parameters

userIdstringrequired

OZZOBiT user ID

Response Schema

statusstring

NOT_STARTED | PENDING_REVIEW | APPROVED | REJECTED | RETRY_NEEDED

levelstring

TIER_0 | TIER_1 | TIER_2 | TIER_3

submittedAtstring | null

ISO 8601 timestamp of submission

reviewedAtstring | null

ISO 8601 timestamp of review completion

rejectionReasonstring | null

Reason if rejected

requiredActionsarray

List of actions needed (if retry needed)

Example

jsonjson

GET /api/v2/kyc/status?userId=OZZOBiT_user_abc123
Authorization: Bearer TOKEN

// Response
{
  "status": "APPROVED",
  "level": "TIER_2",
  "submittedAt": "2024-01-15T09:00:00Z",
  "reviewedAt": "2024-01-15T09:15:00Z",
  "rejectionReason": null,
  "requiredActions": []
}