API Reference
Programmatic access to Indian DID provisioning, number wiring, outbound calls, and bring-your-own-carrier trunks on the Edesy Voice Platform.
Base URL: https://voice-api.edesy.in/v1
All requests are made over HTTPS and authenticated with a Bearer token — see Authentication. Successful responses wrap the payload in a data object; errors wrap it in an error object (see Error Codes).
Phone numbers — provision and wire
DID ownership and on-demand wiring for inbound and outbound over the VoiceLink carrier. Full reference: Phone Numbers.
| Method | Path | Description |
|---|---|---|
POST |
/dids/purchase-live |
Purchase an Indian DID (ownership only) |
GET |
/phone-numbers |
List your numbers (returns each phone_number_id) |
GET |
/phone-numbers/:id/telephony |
Inspect a number's live wiring state |
POST |
/phone-numbers/:id/carrier |
Register on VoiceLink — enables outbound |
DELETE |
/phone-numbers/:id/carrier |
Deregister the number |
PUT |
/phone-numbers/:id/inbound |
Bind inbound to a voice agent or webhook |
DELETE |
/phone-numbers/:id/inbound |
Unbind inbound (outbound stays intact) |
Calls — outbound and streaming
Create outbound calls for a custom WebSocket agent, check status, and hang up. Full reference: Calls.
| Method | Path | Description |
|---|---|---|
POST |
/calls |
Originate a call over VoiceLink (caller-ID = your registered number) |
POST |
/Accounts/{sid}/Calls |
Create an outbound call for a WebSocket streaming agent |
GET |
/Accounts/{sid}/Calls/{callSid} |
Get call status |
DELETE |
/Accounts/{sid}/Calls/{callSid} |
Hang up an active call |
BYOC — bring your own carrier
Register your own SIP trunk, its gateways, and numbers. Full reference: BYOC.
| Method | Path | Description |
|---|---|---|
POST GET |
/trunk-portal/carriers |
Create / list carriers |
GET PATCH DELETE |
/trunk-portal/carriers/:carrier_sid |
Get / update / delete a carrier |
POST GET |
/trunk-portal/carriers/:carrier_sid/gateways |
Create / list gateways |
DELETE |
/trunk-portal/carriers/:carrier_sid/gateways/:gateway_sid |
Delete a gateway |
POST GET |
/trunk-portal/numbers |
Register / list numbers |
PATCH DELETE |
/trunk-portal/numbers/:number_sid |
Update / remove a number |
POST GET |
/trunk-portal/applications |
Create / list applications |
GET PATCH DELETE |
/trunk-portal/applications/:app_sid |
Get / update / delete an application |
GET |
/trunk-portal/call-logs |
List call detail records |
Conventions
- Indian numbers are shown with country code (e.g.
917969002802) or E.164 (+919876543210) depending on the endpoint. - Timestamps are RFC 3339 / ISO 8601 in UTC.
- SIDs are opaque UUID-style identifiers returned by create calls.