Submit KYC details
Submit the KYC (Know Your Customer) details required by Indian telecom regulations before a business number can go live. Verify as an `individual` (PAN details) or as a `business` (PAN plus business name and GST number).
Submit the KYC (Know Your Customer) details required by Indian telecom regulations before a business number can go live. Verify as an individual (PAN details) or as a business (PAN plus business name and GST number).
Authorization
ApiKeyAuth Voice platform authentication secret. Create one from the API Keys endpoint or your dashboard.
In: header
Path Parameters
Provisioning job id from the select step.
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
curl -X POST "https://example.com/dids/managed/string/kyc" \ -H "Content-Type: application/json" \ -d '{ "accountType": "business", "fullName": "Priya Sharma", "email": "priya@acme.in", "phone": "+919876543210", "billingAddress": "221B MG Road, Bengaluru, KA 560001", "panNumber": "ABCDE1234F", "panHolderName": "Priya Sharma", "businessName": "Acme Retail Pvt Ltd", "gstNumber": "29ABCDE1234F1Z5" }'{ "id": "job_9f2ka", "status": "kyc_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" } ]}{ "statusCode": 400, "message": [ "name should not be empty" ], "error": "Bad Request"}{ "statusCode": 401, "message": "Unauthorized", "error": "Unauthorized"}Start Aadhaar verification POST
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`.
Create schedule POST
Queue a batch of outbound calls to be dispatched at a future time.