Get KYC Reliance Status

Check the status of a KYC reliance submission

GET
texttext
/api/v2/kyc-reliance/status

Checks the current status of a previously submitted KYC reliance request.

Query Parameters

submissionIdstringrequired
KYC reliance submission ID
partnerCustomerIdstring
Alternative: your user ID

Response Schema

submissionIdstring
Submission reference
statusstring
PENDING | ACCEPTED | REJECTED | EXPIRED
mappedLevelstring
Mapped OZZOBiT KYC level (if accepted)
providerStatusstring
External provider's status
verifiedAtstring | null
ISO 8601 timestamp when verified
rejectionReasonstring | null
Reason if rejected

Example

jsonjson
GET /api/v2/kyc-reliance/status?submissionId=reliance_sub_abc123
// Response:
{
  "submissionId": "reliance_sub_abc123",
  "status": "ACCEPTED",
  "mappedLevel": "TIER_2",
  "providerStatus": "VERIFIED",
  "verifiedAt": "2024-01-15T09:20:00Z",
  "rejectionReason": null
}