List numbers
Retrieve every phone number connected to the workspace — both numbers you brought yourself (`mode: byo`) and managed business numbers provisioned through our carrier partner (`mode: managed`).
Retrieve every phone number connected to the workspace — both numbers you brought yourself (mode: byo) and managed business numbers provisioned through our carrier partner (mode: managed).
Authorization
ApiKeyAuth Voice platform authentication secret. Create one from the API Keys endpoint or your dashboard.
In: header
Response Body
application/json
application/json
curl -X GET "https://example.com/dids"{ "data": [ { "id": "did_55ka2", "didNumber": "+918045551234", "provider": "plivo", "mode": "byo", "countryCode": "IN", "didType": null, "agentId": null, "isDefault": true, "provisioningStatus": "active", "updatedAt": "2026-06-10T08:00:00Z" }, { "id": "did_81mm9", "didNumber": "+911408620000", "provider": "carrier", "mode": "managed", "countryCode": "IN", "didType": "mobile", "agentId": "agt_8skd92ja", "isDefault": false, "provisioningStatus": "active", "updatedAt": "2026-06-18T11:30:00Z" } ]}{ "statusCode": 401, "message": "Unauthorized", "error": "Unauthorized"}Get provisioning status GET
Poll a provisioning job. KYC verification state is refreshed automatically on each poll, so the job advances to `kyc_verified` on its own once the applicant finishes DigiLocker.
Select a number POST
Reserve a number from the catalog and start a provisioning job. Returns the job — use its `id` for the remaining steps of the flow.