> ## 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.

<Info>
  **Enterprise Feature** - Custom dialing is only available on Enterprise plans. Contact your Bland representative for access.
</Info>

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

### Headers

<ParamField header="authorization" type="string" required>
  Your API key for authentication.
</ParamField>

### Path Parameters

<ParamField path="pool_id" type="string" required>
  The unique identifier of the custom dialing pool to retrieve.

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

### Response

<ResponseField name="status" type="string">
  Can be `success` or `error`.
</ResponseField>

<ResponseField name="data" type="object">
  The custom dialing pool object (present only if status is `success`).

  <Expandable title="data properties">
    <ResponseField name="id" type="string">
      Unique identifier for the pool.
    </ResponseField>

    <ResponseField name="owner_id" type="string">
      Organization ID that owns this pool.
    </ResponseField>

    <ResponseField name="phone_numbers" type="array">
      Array of phone numbers in the pool.
    </ResponseField>

    <ResponseField name="encrypted_key" type="string">
      UUID of associated Twilio credentials (or null if none).
    </ResponseField>

    <ResponseField name="created_at" type="string">
      Timestamp when the pool was created.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="errors" type="array">
  Array of error objects (present only if status is `error`).

  <Expandable title="error object properties">
    <ResponseField name="error" type="string">
      Error code indicating the type of error.
    </ResponseField>

    <ResponseField name="message" type="string">
      Human-readable error message.
    </ResponseField>
  </Expandable>
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl -X GET "https://us.api.bland.ai/v1/custom-dialing-pools/550e8400-e29b-41d4-a716-446655440001" \
    -H "Authorization: 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': '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": "YOUR_API_KEY"
  }

  response = requests.get(url, headers=headers)
  print(response.json())
  ```
</RequestExample>

<ResponseExample>
  ```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"
      }
    ]
  }
  ```
</ResponseExample>

***

Docs for agents: [llms.txt](/llms.txt)