GET

api

platform

telephony

providers-configurations

Get All Providers

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

import requests

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

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-configurations/', 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-configurations/",
  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-configurations/"

	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-configurations/")
  .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-configurations/")

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": "Provider configurations fetched successfully.",
  "data": [
    {
      "id": 42,
      "provider": "twilio",
      "account_sid": "ACxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
      "created_at": "2026-02-07T10:00:00Z"
    },
    {
      "id": 43,
      "provider": "plivo",
      "account_sid": "MAyyyyyyyyyyyyyyyyyyyyyyy",
      "created_at": "2026-02-10T09:00:00Z"
    }
  ]
}

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

{
  "status_code": 200,
  "message": "Provider configurations fetched successfully.",
  "data": [
    {
      "id": 42,
      "provider": "twilio",
      "account_sid": "ACxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
      "created_at": "2026-02-07T10:00:00Z"
    },
    {
      "id": 43,
      "provider": "plivo",
      "account_sid": "MAyyyyyyyyyyyyyyyyyyyyyyy",
      "created_at": "2026-02-10T09:00:00Z"
    }
  ]
}

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

Get All Provider Configurations

Retrieve all telephony provider configurations that have been set up for your organization. Each configuration represents a set of credentials (account SID) linked to a specific telephony provider.

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

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 configuration objects

Provider Config Object Fields

Field	Type	Description
id	integer	Unique provider configuration identifier
provider	string	Provider slug/identifier
account_sid	string	Account SID for the provider
created_at	string	Configuration creation timestamp

Common Error Codes

Status Code	Description
200	Success - Configurations 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 provider configurations
const getAllProviders = async () => {
  const response = await axios.get(
    'https://unpod.ai/api/v2/platform/telephony/providers-configurations/',
    { headers }
  );
  console.log(`Total configurations: ${response.data.data.length}`);
  response.data.data.forEach(config => {
    console.log(`Config #${config.id}: ${config.provider} - ${config.account_sid}`);
  });
  return response.data.data;
};

// Example usage
getAllProviders();

import requests

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

def get_all_providers():
    """Get all provider configurations"""
    url = 'https://unpod.ai/api/v2/platform/telephony/providers-configurations/'
    response = requests.get(url, headers=headers)
    data = response.json()
    print(f"Total configurations: {len(data['data'])}")
    for config in data['data']:
        print(f"Config #{config['id']}: {config['provider']} - {config['account_sid']}")
    return data['data']

# Example usage
get_all_providers()

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

Best Practices

Configuration ID: Note each configuration id - it is used when connecting a provider to a bridge
Multiple Providers: You can have configurations for multiple providers to support different regions
Security: auth_token is never returned in responses for security - only account_sid is shown
Error Handling: Always handle potential errors and edge cases
Regular Auditing: Periodically review and remove unused provider configurations

Authorizations

Authorization

string

header

required

Format: Token

Headers

Org-Handle

string

required

Organization domain handle

Example:

"unpod.tv"

Response

List of provider configurations

Get Provider by IDRetrieve a specific telephony provider configuration by its ID

Get All Providers

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

import requests

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

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-configurations/', 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-configurations/",
  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-configurations/"

	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-configurations/")
  .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-configurations/")

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": "Provider configurations fetched successfully.",
  "data": [
    {
      "id": 42,
      "provider": "twilio",
      "account_sid": "ACxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
      "created_at": "2026-02-07T10:00:00Z"
    },
    {
      "id": 43,
      "provider": "plivo",
      "account_sid": "MAyyyyyyyyyyyyyyyyyyyyyyy",
      "created_at": "2026-02-10T09:00:00Z"
    }
  ]
}

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

Getting Started

API Lists

Get All Providers

Get All Provider Configurations

Headers

Response Fields

Provider Config Object Fields

Common Error Codes

Code Examples

Best Practices

Authorizations

Headers

Response

​Get All Provider Configurations

​Headers

​Response Fields

​Provider Config Object Fields

​Common Error Codes

​Code Examples

​Best Practices

Authorizations

Headers

Response

Get All Provider Configurations

Headers

Response Fields

Provider Config Object Fields

Common Error Codes

Code Examples

Best Practices