Retrieve list of all telephony numbers
| Name | Type | Required | Description |
|---|---|---|---|
| Authorization | string | Yes | API Key format: Token <token> |
| Org-Handle | string | Yes | Organization domain handle |
Org-Handle by hitting the Get All Organizations API. The domain_handle field in the response is your Org-Handle.| Field | Type | Description |
|---|---|---|
| status_code | integer | HTTP status code |
| message | string | Response message |
| data | array | Array of number objects |
| 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 |
| 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 |
bridge_slug to identify unassigned numbers available for new bridge connectionsstatus: active can handle calls — filter inactive numbers in your applicationprovider field to understand which provider account each number belongs to