Get Telephony Numbers
Telephony & Bridges
Get Telephony Numbers
Retrieve list of all telephony numbers
GET
Get Telephony Numbers
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 Telephony Numbers
Retrieve a list of all telephony numbers associated with your organization. This includes all numbers from connected providers, along with their assignment status, bridge associations, and current activity state.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 number objects |
Number Object Fields
| Field | Type | Description |
|---|---|---|
| id | integer | Unique number identifier |
| number | string | Phone number in E.164 format |
| provider | string | Provider slug this number belongs to |
| bridge_slug | string | Slug of the bridge this number is assigned to (null if unassigned) |
| status | string | Number status: active, inactive |
Common Error Codes
| Status Code | Description |
|---|---|
| 200 | Success - Numbers fetched successfully |
| 401 | Unauthorized - Invalid or missing API token |
| 403 | Forbidden - Invalid organization handle |
| 404 | Not Found - Organization not found |
| 500 | Internal Server Error - Server-side error |
Code Examples
Best Practices
- Bridge Assignment: Check
bridge_slugto identify unassigned numbers available for new bridge connections - Status Check: Only numbers with
status: activecan handle calls — filter inactive numbers in your application - Provider Tracking: Use the
providerfield to understand which provider account each number belongs to - Number Inventory: Regularly audit your number list to identify unused or misconfigured numbers
- E.164 Format: All numbers are returned in E.164 format — use this format consistently in all API calls
- Security: Keep API tokens secure and rotate them regularly