DID Routing

Start Aadhaar verification

Begin Aadhaar identity verification for the job. Returns an `aadhaarRedirectUrl` pointing to DigiLocker (the Indian government's document service) — send the applicant there to consent and complete verification, then poll the job until its status reaches `kyc_verified`.

POST
/dids/managed/{jobId}/kyc/aadhaar/init

Begin Aadhaar identity verification for the job. Returns an aadhaarRedirectUrl pointing to DigiLocker (the Indian government's document service) — send the applicant there to consent and complete verification, then poll the job until its status reaches kyc_verified.

Authorization

ApiKeyAuth
X-API-Key<token>

Voice platform authentication secret. Create one from the API Keys endpoint or your dashboard.

In: header

Path Parameters

jobId*string

Provisioning job id.

Response Body

application/json

application/json

application/json

curl -X POST "https://example.com/dids/managed/string/kyc/aadhaar/init"
{  "id": "job_9f2ka",  "status": "kyc_aadhaar_pending",  "selectedDidNumber": "+911408620000",  "steps": [    {      "label": "Number reserved",      "status": "completed"    },    {      "label": "KYC verified",      "status": "current"    },    {      "label": "Number purchased & assigned",      "status": "pending"    },    {      "label": "Inbound routing configured",      "status": "pending"    },    {      "label": "Status webhook configured",      "status": "pending"    },    {      "label": "Ready for inbound calls",      "status": "pending"    }  ],  "aadhaarRedirectUrl": "https://digilocker.meripehchaan.gov.in/…"}
{  "statusCode": 400,  "message": [    "name should not be empty"  ],  "error": "Bad Request"}
{  "statusCode": 401,  "message": "Unauthorized",  "error": "Unauthorized"}