Get KYC status

Reseller accounts only. Request access.

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",
      "carrier": "carrier-1",
      "carrier_label": "Carrier 1",
      "kyc_required": true,
      "can_purchase": false,
      "status": "pan_verified",
      "next_step": "aadhaar-otp",
      "review_status": null
    },
    {
      "region": "IN",
      "carrier": "carrier-2-new",
      "carrier_label": "Carrier 2 (new)",
      "kyc_required": true,
      "can_purchase": false,
      "status": "not_started",
      "next_step": "register",
      "review_status": null
    }
  ]
}

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.

There is one entry per carrier, not per region. Verification is per carrier, so a client verified on one carrier of a region still has to verify on the other before it can buy there. Match on carrier, and pass that same name to the steps and to the purchase.

can_purchase is the exact gate a purchase enforces, so this answer and a purchase attempt can never disagree. When it is false while next_step is null, the client has finished every step and the carrier is still reviewing: review_status says pending_review.

The full loop, with the step tables, is in the Reseller API guide.