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

# List Available Numbers

> Your 60db Dialer numbers, and which ones already have a phone line

List the 60db Dialer numbers you own. Use one as `number` when you [create a phone line](https://docs.60db.ai/api-reference/agents/create-phone-line.md). `in_use: true` means the number already has a phone line.

Buy numbers in [Dialer](https://docs.60db.ai/features/dialer.md). Renting is billed from your Dialer balance.

## Request

### Headers

**Authorization** `string` *required*

Bearer token with your API key (scope `agents`)

## Response

**200 OK**

```json theme={null}
{
  "success": true,
  "data": {
    "numbers": [
      { "number": "+919876543210", "in_use": true },
      { "number": "+918012345678", "in_use": false }
    ]
  }
}
```

If you own no numbers, `numbers` is an empty array.

## Errors

No endpoint-specific errors. Access and permission errors are listed in [Agents](https://docs.60db.ai/features/agents.md#errors).

## Example

```bash cURL theme={null}
curl https://api.60db.ai/agents/phone-lines/available-numbers \
  -H "Authorization: Bearer your-api-key"
```

```javascript JavaScript theme={null}
const { numbers } = await client.agents.phoneLines.availableNumbers();
const free = numbers.find((n) => !n.in_use);
```

```python Python theme={null}
numbers = client.agents.phone_lines.available_numbers()["numbers"]
free = next(n for n in numbers if not n["in_use"])
```


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