Phone numbers

List the numbers your workspace owns.

The numbers your workspace owns - the ones you can use as caller ID on a call or campaign. Number provisioning (buying and releasing) is console-only because it involves Indian regulatory linkage, so the API exposes read access only.

Number object:

{
  "number": "+918045678900",
  "country": "IN",
  "type": "local",
  "status": "active",
  "voiceEnabled": true,
  "smsEnabled": false
}

List numbers

GET /v1/numbers  ·  scope numbers:read

{ "data": [ { "number": "+91…", "status": "active", "voiceEnabled": true, … } ] }

Returns every number the workspace owns. Use an active number’s value as fromNumber when placing a call or in a campaign’s settings.fromNumber.

Buying numbers

To rent or release a number, use the console - see Phone numbers in the product guide. There is no numbers:write endpoint on the API.

Next: Webhooks & events →