Get KYC status
Get the identity verification status of a client for every region where verification is required. Use next_step to know which step to call next, so you drive the whole flow off one poll instead of hardcoding the sequence.
Reseller accounts only. Request access.
user_idintegerrequiredID of the child user to check.
curl -X GET 'https://backend.omnidim.io/api/v1/reseller/kyc/status?user_id=1234' \ -H 'Authorization: Bearer YOUR_API_KEY'
{ "success": true, "user_id": 1234, "regions": [ { "region": "IN", "kyc_required": true, "can_purchase": false, "status": "pan_verified", "next_step": "aadhaar-otp" } ] }
Authorization
BearerAuth Bearer token authentication. Obtain your API key from the OmniDimension dashboard.
In: header
Query Parameters
ID of the child user to check.
Response Body
application/json
application/json
application/json
application/json
next_step is the field to drive your integration from: read it once here to
get the first step, then chain from each step's response until the status is
completed.
can_purchase is the exact gate a purchase enforces, so this answer and a
purchase attempt can never disagree.
The full loop, with the step table, is in the Reseller API guide.
Credit transfer logs
Paginated history of all credit transfers and reverts for the reseller account. Returns reverse-chronological order by default. Date filters are inclusive.
Get KYC requirements for a region
Get the ordered list of verification steps for a region and the fields each step needs, so your integration can build a verification form without hardcoding the sequence.
