> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bland.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Custom Dialing Pool

> Retrieve a specific custom dialing pool by its ID.

> [!NOTE]
>
> **Enterprise Feature** - Custom dialing is only available on Enterprise plans. Contact your Bland representative for access.

Retrieve details for a specific custom dialing pool using its unique identifier.

### Headers

**authorization** `string` *required*

Your API key for authentication.

### Path Parameters

**pool\_id** `string` *required*

The unique identifier of the custom dialing pool to retrieve.

**Format**: UUID format (e.g., `550e8400-e29b-41d4-a716-446655440000`)

### Response

**status** `string`

Can be `success` or `error`.

**data** `object`

The custom dialing pool object (present only if status is `success`).

**data properties**

**id** `string`

Unique identifier for the pool.

**owner\_id** `string`

Organization ID that owns this pool.

**phone\_numbers** `array`

Array of phone numbers in the pool.

**encrypted\_key** `string`

UUID of associated Twilio credentials (or null if none).

**created\_at** `string`

Timestamp when the pool was created.

**errors** `array`

Array of error objects (present only if status is `error`).

**error object properties**

**error** `string`

Error code indicating the type of error.

**message** `string`

Human-readable error message.

```bash cURL theme={null}
curl -X GET "https://us.api.bland.ai/v1/custom-dialing-pools/550e8400-e29b-41d4-a716-446655440001" \
  -H "Authorization: Bearer YOUR_API_KEY"
```

```javascript JavaScript theme={null}
const poolId = '550e8400-e29b-41d4-a716-446655440001';
const response = await fetch(`https://us.api.bland.ai/v1/custom-dialing-pools/${poolId}`, {
  method: 'GET',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
  }
});

const data = await response.json();
console.log(data);
```

```python Python theme={null}
import requests

pool_id = "550e8400-e29b-41d4-a716-446655440001"
url = f"https://us.api.bland.ai/v1/custom-dialing-pools/{pool_id}"
headers = {
    "Authorization": "Bearer YOUR_API_KEY"
}

response = requests.get(url, headers=headers)
print(response.json())
```

```json Success Response theme={null}
{
  "status": "success",
  "data": {
    "id": "550e8400-e29b-41d4-a716-446655440001",
    "owner_id": "550e8400-e29b-41d4-a716-446655440002",
    "phone_numbers": ["+12345678901", "+19876543210", "+15551234567"],
    "encrypted_key": "550e8400-e29b-41d4-a716-446655440000",
    "created_at": "2024-01-15T10:30:00Z"
  },
  "errors": null
}
```

```json Error Response - Pool Not Found theme={null}
{
  "status": "error",
  "data": null,
  "errors": [
    {
      "error": "POOL_NOT_FOUND",
      "message": "Geospatial dialing pool not found"
    }
  ]
}
```

```json Error Response - Invalid Pool ID theme={null}
{
  "status": "error",
  "data": null,
  "errors": [
    {
      "error": "INVALID_POOL_ID",
      "message": "Pool ID must be a valid UUID"
    }
  ]
}
```

```json Error Response - Unauthorized theme={null}
{
  "status": "error",
  "data": null,
  "errors": [
    {
      "error": "UNAUTHORIZED",
      "message": "Invalid API key or insufficient permissions"
    }
  ]
}
```

***

Docs for agents: [llms.txt](https://docs.bland.ai/llms.txt)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.