GET

api

platform

telephony

providers

Get Telephony Providers

curl --request GET \
  --url https://unpod.ai/api/v2/platform/telephony/providers/ \
  --header 'Authorization: <api-key>' \
  --header 'Org-Handle: <org-handle>'

import requests

url = "https://unpod.ai/api/v2/platform/telephony/providers/"

headers = {
    "Org-Handle": "<org-handle>",
    "Authorization": "<api-key>"
}

response = requests.get(url, headers=headers)

print(response.text)

const options = {
  method: 'GET',
  headers: {'Org-Handle': '<org-handle>', Authorization: '<api-key>'}
};

fetch('https://unpod.ai/api/v2/platform/telephony/providers/', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://unpod.ai/api/v2/platform/telephony/providers/",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: <api-key>",
    "Org-Handle: <org-handle>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

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

func main() {

	url := "https://unpod.ai/api/v2/platform/telephony/providers/"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Org-Handle", "<org-handle>")
	req.Header.Add("Authorization", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://unpod.ai/api/v2/platform/telephony/providers/")
  .header("Org-Handle", "<org-handle>")
  .header("Authorization", "<api-key>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://unpod.ai/api/v2/platform/telephony/providers/")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Org-Handle"] = '<org-handle>'
request["Authorization"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "status_code": 200,
  "message": "Voice infra providers fetched successfully.",
  "data": [
    {
      "id": 1,
      "name": "Twilio",
      "slug": "twilio"
    },
    {
      "id": 2,
      "name": "Plivo",
      "slug": "plivo"
    }
  ]
}

{
  "status_code": 401,
  "message": "Authentication credentials were not provided."
}

{
  "status_code": 200,
  "message": "Voice infra providers fetched successfully.",
  "data": [
    {
      "id": 1,
      "name": "Twilio",
      "slug": "twilio"
    },
    {
      "id": 2,
      "name": "Plivo",
      "slug": "plivo"
    }
  ]
}

{
  "status_code": 401,
  "message": "Authentication credentials were not provided."
}

Get Telephony Providers

Retrieve a list of all available telephony providers in the system. These are the supported providers that you can configure credentials for using the Provider Configurations endpoints.

Prerequisites: Make sure you have your API Token and Org-Handle ready. See Authentication for details.

Get Telephony Providers

Retrieve all supported telephony providers available for configuration.

GET /api/v2/platform/telephony/providers/

Headers

Name	Type	Required	Description
Authorization	string	Yes	API Key format: `Token <token>`
Org-Handle	string	Yes	Organization domain handle

You can get the Org-Handle by hitting the Get All Organizations API. The domain_handle field in the response is your Org-Handle.

Response Fields

Field	Type	Description
status_code	integer	HTTP status code
message	string	Response message
data	array	Array of provider objects

Provider Object Fields

Field	Type	Description
id	integer	Provider unique identifier
name	string	Provider display name
slug	string	URL-friendly provider identifier used in config API

Common Error Codes

Status Code	Description
200	Success - Providers fetched successfully
401	Unauthorized - Invalid or missing API token
403	Forbidden - Invalid organization handle
500	Internal Server Error - Server-side error

Code Examples

const axios = require('axios');

const headers = {
  'Authorization': 'Token your-api-token',
  'Org-Handle': 'your-org-handle'
};

// Get all available telephony providers
const getTelephonyProviders = async () => {
  const response = await axios.get(
    'https://unpod.ai/api/v2/platform/telephony/providers/',
    { headers }
  );
  console.log(`Available providers: ${response.data.data.length}`);
  response.data.data.forEach(provider => {
    console.log(`${provider.name} (id: ${provider.id}, slug: ${provider.slug})`);
  });
  return response.data.data;
};

// Example usage
getTelephonyProviders();

import requests

headers = {
    'Authorization': 'Token your-api-token',
    'Org-Handle': 'your-org-handle'
}

def get_telephony_providers():
    """Get all available telephony providers"""
    url = 'https://unpod.ai/api/v2/platform/telephony/providers/'
    response = requests.get(url, headers=headers)
    data = response.json()
    print(f"Available providers: {len(data['data'])}")
    for provider in data['data']:
        print(f"{provider['name']} (id: {provider['id']}, slug: {provider['slug']})")
    return data['data']

# Example usage
get_telephony_providers()

# Get all telephony providers
curl -X GET "https://unpod.ai/api/v2/platform/telephony/providers/" \
  -H "Authorization: Token your-api-token" \
  -H "Org-Handle: your-org-handle"

Best Practices

Provider ID: Use the id field when creating provider configurations via the Create Provider endpoint
Provider Selection: Choose the provider that best suits your region and call volume requirements
Caching: Cache the providers list locally since it changes infrequently
Error Handling: Always handle potential errors and implement retry logic
Security: Keep API tokens secure and rotate them regularly

Authorizations

Authorization

string

header

required

Format: Token

Headers

Org-Handle

string

required

Organization domain handle

Example:

"unpod.tv"

Response

List of available telephony providers

Create ProviderCreate a new telephony provider configuration

Get Telephony Providers

curl --request GET \
  --url https://unpod.ai/api/v2/platform/telephony/providers/ \
  --header 'Authorization: <api-key>' \
  --header 'Org-Handle: <org-handle>'

import requests

url = "https://unpod.ai/api/v2/platform/telephony/providers/"

headers = {
    "Org-Handle": "<org-handle>",
    "Authorization": "<api-key>"
}

response = requests.get(url, headers=headers)

print(response.text)

const options = {
  method: 'GET',
  headers: {'Org-Handle': '<org-handle>', Authorization: '<api-key>'}
};

fetch('https://unpod.ai/api/v2/platform/telephony/providers/', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://unpod.ai/api/v2/platform/telephony/providers/",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: <api-key>",
    "Org-Handle: <org-handle>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

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

func main() {

	url := "https://unpod.ai/api/v2/platform/telephony/providers/"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Org-Handle", "<org-handle>")
	req.Header.Add("Authorization", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://unpod.ai/api/v2/platform/telephony/providers/")
  .header("Org-Handle", "<org-handle>")
  .header("Authorization", "<api-key>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://unpod.ai/api/v2/platform/telephony/providers/")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Org-Handle"] = '<org-handle>'
request["Authorization"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "status_code": 200,
  "message": "Voice infra providers fetched successfully.",
  "data": [
    {
      "id": 1,
      "name": "Twilio",
      "slug": "twilio"
    },
    {
      "id": 2,
      "name": "Plivo",
      "slug": "plivo"
    }
  ]
}

{
  "status_code": 401,
  "message": "Authentication credentials were not provided."
}

Getting Started

API Lists

Get Telephony Providers

Get Telephony Providers

Get Telephony Providers

Headers

Response Fields

Provider Object Fields

Common Error Codes

Code Examples

Best Practices

Authorizations

Headers

Response

​Get Telephony Providers

​Get Telephony Providers

​Headers

​Response Fields

​Provider Object Fields

​Common Error Codes

​Code Examples

​Best Practices

Authorizations

Headers

Response

Get Telephony Providers

Get Telephony Providers

Headers

Response Fields

Provider Object Fields

Common Error Codes

Code Examples

Best Practices