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

# List Numbers

> Retrieves a list of all inbound phone numbers configured for your account, along with their associated settings.

### Headers

**authorization** `string` *required*

Your API key for authentication.

**encrypted\_key** `string`

Use your own Twilio account and only return inbound numbers associated with that account sid (optional).

Learn more about BYOT [here](https://docs.bland.ai/tutorials/custom-twilio.md).

### Response

**inbound\_numbers** `array`

An array of objects, each representing an inbound phone number and its configuration.

```json Response theme={null}
{
    "inbound_numbers": [
        {
            "created_at": "2023-11-27T17:21:38.33359+00:00",
            "phone_number": "+18005551234",
            "prompt": "When you receive a call, recite a random poem from 'Sunset Boulevard' and then ask, 'How may I assist you in your poetic journey today?'",
            "webhook": "https://api.example.com/poetry-line",
            "voice_id": 2,
            "dynamic_data": [/* Use [Dynamic Data](/api-reference/endpoint/dynamic_validate) to make API requests mid-call */],
            "interruption_threshold": null,
            "first_sentence": null,
            "reduce_latency": true,
            "transfer_phone_number": null,
            "voice_settings": null,
            "record": false,
            "max_duration": 30
        },
        {
            "created_at": "2023-11-25T21:42:22.325993+00:00",
            "phone_number": "+18005559876",
            "prompt": "Answer with 'You've reached the Secret Society of Enigmatic Enthusiasts. Please state the password or leave a message after the beep.'",
            "webhook": "https://mysteryclub.example.com/inbound-call-hook",
            "voice_id": 1,
            "dynamic_data": null,
            "interruption_threshold": null,
            "first_sentence": null,
            "reduce_latency": true,
            "transfer_phone_number": null,
            "voice_settings": null,
            "record": false,
            "max_duration": 30
        },
        //...
    ]
}

```

***

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.