GET

api

platform

telephony

bridges

Get All Bridges

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

import requests

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

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

	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/bridges/")
  .header("Org-Handle", "<org-handle>")
  .header("Authorization", "<api-key>")
  .asString();

require 'uri'
require 'net/http'

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

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

{
  "count": 6,
  "status_code": 200,
  "message": "Bridges fetched successfully.",
  "data": [
    {
      "id": 314,
      "name": "Sales Bridge",
      "slug": "sales-bridge-001",
      "provider": "twilio",
      "numbers": [
        {
          "id": 501,
          "number": "+1234567890",
          "status": "active"
        }
      ]
    }
  ]
}

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

{
  "count": 6,
  "status_code": 200,
  "message": "Bridges fetched successfully.",
  "data": [
    {
      "id": 314,
      "name": "Sales Bridge",
      "slug": "sales-bridge-001",
      "provider": "twilio",
      "numbers": [
        {
          "id": 501,
          "number": "+1234567890",
          "status": "active"
        }
      ]
    }
  ]
}

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

Get All Bridges

Retrieve a list of all telephony bridges in your organization, including their IDs, names, slugs, associated providers, and linked phone numbers for monitoring and call-routing management.

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
count	integer	Total number of bridges
status_code	integer	HTTP status code
message	string	Response message
data	array	Array of bridge objects

Bridge Object Fields

Field	Type	Description
id	integer	Bridge unique identifier
name	string	Bridge display name
slug	string	Unique bridge slug identifier
provider	string	Connected provider slug (null if none)
numbers	array	List of phone numbers assigned to the bridge

Number Object Fields

Field	Type	Description
id	integer	Number assignment ID
number	string	Phone number (E.164 format)
status	string	Number status: `active`, `inactive`

Common Error Codes

Status Code	Description
200	Success - Bridges 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 bridges
const getAllBridges = async () => {
  const response = await axios.get(
    'https://unpod.ai/api/v2/platform/telephony/bridges/',
    { headers }
  );
  console.log(`Total bridges: ${response.data.count}`);
  response.data.data.forEach(bridge => {
    console.log(`${bridge.name} (${bridge.slug}) - Numbers: ${bridge.numbers.length}`);
  });
  return response.data.data;
};

// Example usage
getAllBridges();

import requests

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

def get_all_bridges():
    """Get all telephony bridges"""
    url = 'https://unpod.ai/api/v2/platform/telephony/bridges/'
    response = requests.get(url, headers=headers)
    data = response.json()
    print(f"Total bridges: {data['count']}")
    for bridge in data['data']:
        print(f"{bridge['name']} ({bridge['slug']}) - Numbers: {len(bridge['numbers'])}")
    return data['data']

# Example usage
get_all_bridges()

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

Best Practices

Bridge Slug: Note each bridge’s slug - it is used as a path parameter in other bridge endpoints
Provider Check: Verify bridges have a connected provider before routing calls through them
Number Assignment: Bridges without numbers in the numbers[] array cannot receive inbound calls
Error Handling: Always handle potential errors and edge cases
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 all bridges

Get Bridge by SlugRetrieve details of a specific telephony bridge using its slug

Get All Bridges

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

import requests

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

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

	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/bridges/")
  .header("Org-Handle", "<org-handle>")
  .header("Authorization", "<api-key>")
  .asString();

require 'uri'
require 'net/http'

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

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

{
  "count": 6,
  "status_code": 200,
  "message": "Bridges fetched successfully.",
  "data": [
    {
      "id": 314,
      "name": "Sales Bridge",
      "slug": "sales-bridge-001",
      "provider": "twilio",
      "numbers": [
        {
          "id": 501,
          "number": "+1234567890",
          "status": "active"
        }
      ]
    }
  ]
}

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

Getting Started

API Lists

Get All Bridges

Get All Bridges

Headers

Response Fields

Bridge Object Fields

Number Object Fields

Common Error Codes

Code Examples

Best Practices

Authorizations

Headers

Response

​Get All Bridges

​Headers

​Response Fields

​Bridge Object Fields

​Number Object Fields

​Common Error Codes

​Code Examples

​Best Practices

Authorizations

Headers

Response

Get All Bridges

Headers

Response Fields

Bridge Object Fields

Number Object Fields

Common Error Codes

Code Examples

Best Practices