List All ExoPhones

Retrieve all ExoPhones in your account.

HTTP Request

GET /v2_beta/Accounts/<account_sid>/IncomingPhoneNumbers

Code Examples

cURL

curl -u '<api_key>:<api_token>' -X GET 'https://api.exotel.com/v2_beta/Accounts/<account_sid>/IncomingPhoneNumbers'

Python

import requests

response = requests.get(
    'https://api.exotel.com/v2_beta/Accounts/<account_sid>/IncomingPhoneNumbers',
    auth=('<api_key>', '<api_token>')
)

print(response.status_code)
print(response.json())

Node.js

const apiKey = '<api_key>';
const apiToken = '<api_token>';

const url = 'https://api.exotel.com/v2_beta/Accounts/<account_sid>/IncomingPhoneNumbers';

const response = await fetch(url, {
  method: 'GET',
  headers: {
    'Authorization': 'Basic ' + Buffer.from(`${apiKey}:${apiToken}`).toString('base64'),
  },
});

const data = await response.json();
console.log(response.status, data);

PHP

<?php
$ch = curl_init('https://api.exotel.com/v2_beta/Accounts/<account_sid>/IncomingPhoneNumbers');
curl_setopt($ch, CURLOPT_USERPWD, "<api_key>:<api_token>");
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'GET');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

$response = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

echo $status . "\n" . $response;
?>

Go

package main

import (
    "fmt"
    "io"
    "net/http"
)

func main() {
    endpoint := "https://api.exotel.com/v2_beta/Accounts/<account_sid>/IncomingPhoneNumbers"

    req, err := http.NewRequest("GET", endpoint, nil)
    if err != nil {
        panic(err)
    }
    req.SetBasicAuth("<api_key>", "<api_token>")

    res, err := http.DefaultClient.Do(req)
    if err != nil {
        panic(err)
    }
    defer res.Body.Close()

    respBody, _ := io.ReadAll(res.Body)
    fmt.Println(res.StatusCode, string(respBody))
}

Response

{
  "page": 0,
  "page_size": 50,
  "incoming_phone_numbers": [
    {
      "sid": "011XXXXXXX1",
      "phone_number": "+9111XXXXXXX6",
      "friendly_name": "011XXXXXXX6",
      "capabilities": {
        "voice": true,
        "sms": true
      },
      "country": "IN",
      "region": "DL"
    }
  ]
}

Response Fields

Field	Description
page	Current page number
page_size	Number of records per page
incoming_phone_numbers	Array of ExoPhone objects