> ## Documentation Index
> Fetch the complete documentation index at: https://developers.leadwaycrm.com/llms.txt
> Use this file to discover all available pages before exploring further.
# List active numbers
> Retrieve a paginated list of active phone numbers for a specific account. Supports filtering, pagination, and optional exclusion of number pool assignments.
Retrieve a paginated list of active phone numbers for a specific account. Supports filtering, pagination, and optional exclusion of number pool assignments.
```http theme={null}
GET https://services.leadconnectorhq.com/phone-system/numbers/location/{locationId}
```
## Autorización
Bearer token generado desde el portal Leadway. Ver [Autenticación](/authentication).
Versión de la API.
## Path parameters
The unique identifier of the account
## Query parameters
How many resources to return in each list page. The default is 50, and the maximum is 1000.
The page index for pagination. The default is 0.
Filter numbers by phone number pattern. Supports partial matching (e.g., "+91" to find all Indian numbers).
Whether to exclude numbers that are assigned to number pools. Default is true.
## Respuestas
Array of phone number objects with detailed configuration
E.164 formatted phone number
Human-readable name assigned to the number
Phone number SID (unique identifier)
ISO 3166-1 alpha-2 country code
Communication capabilities supported by this number
Whether the number supports voice calls
Whether the number supports SMS messaging
Whether the number supports MMS messaging
Whether the number supports fax transmission
Type of phone number (local, toll-free, mobile, etc.) Posibles valores: 'local', 'toll-free', 'mobile', 'national'
Whether this is the default outbound number for the account
User ID of the user assigned to this number
Array of user IDs that should ring when this number is called
Configuration for inbound call handling service
Type of inbound call service Posibles valores: 'voice\_ai', 'ivr', 'forward'
Service configuration value or ID
Phone number to forward calls to
Whether group conversations are enabled for this number (US/CA numbers with SMS/MMS only)
Address SID for compliance purposes
Bundle SID for regulatory compliance
When the number was originally purchased/added
When the number configuration was last updated
Source or origin of the phone number Posibles valores: 'twilio', 'hosted', 'ported'
Whether this account is manged by LeadconnectorHQ
Number of items requested per page
Current page index (0-based)
Current status of the account Posibles valores: 'active', 'suspended', 'closed'
```json theme={null}
{
"numbers": [
{
"phoneNumber": "+14155552671",
"friendlyName": "Sales Line 1",
"sid": "PN1234567890abcdef1234567890abcde",
"countryCode": "US",
"capabilities": {
"voice": true,
"sms": true,
"mms": true,
"fax": false
},
"type": "local",
"isDefaultNumber": true,
"linkedUser": "user_123456789",
"linkedRingAllUsers": [
"user_123",
"user_456"
],
"inboundCallService": {
"type": "voice_ai",
"value": "68e381b296a83800a27cd1"
},
"forwardingNumber": "+14155552672",
"isGroupConversationEnabled": true,
"addressSid": "AD1234567890abcdef1234567890abcde",
"bundleSid": "BU1234567890abcdef1234567890abcde",
"dateAdded": "2023-01-15T10:30:00Z",
"dateUpdated": "2023-02-20T14:45:00Z",
"origin": "twilio"
},
{
"phoneNumber": "+18005551234",
"friendlyName": "Support Toll-Free",
"sid": "PN9876543210fedcba9876543210fedcb",
"countryCode": "US",
"capabilities": {
"voice": true,
// truncado: 26 lineas mas
}
```
```json theme={null}
{
"message": "Invalid locationId format or pagination parameters",
"error": "Bad Request",
"statusCode": 400
}
```
```json theme={null}
{}
```
```json theme={null}
{
"message": "Phone system is not connected to this account",
"statusCode": 404
}
```
Account status when error occurs
```json theme={null}
{
"msg": "Internal server error",
"accountStatus": "suspended"
}
```
## Ejemplo
```bash cURL theme={null}
curl -X GET 'https://services.leadconnectorhq.com/phone-system/numbers/location/YOUR_locationId' \
-H 'Authorization: Bearer YOUR_TOKEN' \
-H 'Version: 2021-07-28'
```
```javascript Node.js theme={null}
const response = await fetch('https://services.leadconnectorhq.com/phone-system/numbers/location/YOUR_locationId', {
method: 'GET',
headers: {
Authorization: `Bearer ${process.env.LEADWAY_TOKEN}`,
Version: '2021-07-28',
},
});
const data = await response.json();
```
```python Python theme={null}
import os, requests
response = requests.request(
'GET',
'https://services.leadconnectorhq.com/phone-system/numbers/location/YOUR_locationId',
headers={
'Authorization': f"Bearer {os.environ['LEADWAY_TOKEN']}",
'Version': '2021-07-28',
},
)
data = response.json()
```
```php PHP theme={null}
true,
CURLOPT_CUSTOMREQUEST => 'GET',
CURLOPT_HTTPHEADER => [
'Authorization: Bearer ' . getenv('LEADWAY_TOKEN'),
'Version: 2021-07-28',
],
]);
$data = json_decode(curl_exec($ch), true);
```