Get Provider by ID
Providers
Get Provider by ID
Retrieve a specific telephony provider configuration by its ID
GET
Get Provider by ID
Documentation Index
Fetch the complete documentation index at: https://docs.unpod.dev/llms.txt
Use this file to discover all available pages before exploring further.
Get Provider Configuration by ID
Retrieve a specific telephony provider configuration by its unique integer identifier. Use this to inspect the details of a particular provider setup.Prerequisites: Make sure you have your API Token and Org-Handle ready. See Authentication for details.
Path Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| id | integer | Yes | Unique identifier of the provider configuration |
You can get the provider configuration
id by hitting the Get All Providers API.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 | object | Provider configuration details |
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 - Configuration fetched successfully |
| 401 | Unauthorized - Invalid or missing API token |
| 403 | Forbidden - Invalid organization handle |
| 404 | Not Found - Provider configuration not found |
| 500 | Internal Server Error - Server-side error |
Code Examples
Best Practices
- ID Lookup: Use Get All Providers to find IDs before fetching individual records
- Error Handling: Handle 404 responses when a configuration ID is no longer valid
- Security:
auth_tokenis never returned — onlyaccount_sidis visible for security - Org-Handle: Ensure the correct organization handle is used to access configurations within your org
- Validation: Use this endpoint to verify a provider configuration exists before connecting it to a bridge