Skip to main content
GET
/
api
/
v2
/
platform
/
telephony
/
providers-configurations
Get All Providers
curl --request GET \
  --url http://localhost:3001/api/v2/platform/telephony/providers-configurations/ \
  --header 'Authorization: <api-key>' \
  --header 'Org-Handle: <org-handle>'
{
  "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": 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"
    }
  ]
}

​
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

NameTypeRequiredDescription
AuthorizationstringYesAPI Key format: Token <token>
Org-HandlestringYesOrganization 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

FieldTypeDescription
status_codeintegerHTTP status code
messagestringResponse message
dataarrayArray of provider configuration objects

​
Provider Config Object Fields

FieldTypeDescription
idintegerUnique provider configuration identifier
providerstringProvider slug/identifier
account_sidstringAccount SID for the provider
created_atstringConfiguration creation timestamp

​
Common Error Codes

Status CodeDescription
200Success - Configurations fetched successfully
401Unauthorized - Invalid or missing API token
403Forbidden - Invalid organization handle
500Internal 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.dev/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();

​
Best Practices

  1. Configuration ID: Note each configuration id — it is used when connecting a provider to a bridge
  2. Multiple Providers: You can have configurations for multiple providers to support different regions
  3. Security: auth_token is never returned in responses for security — only account_sid is shown
  4. Error Handling: Always handle potential errors and edge cases
  5. 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"

Response

List of provider configurations