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

# Phone numbers

> Select the caller ID used for outbound calls.

Phone numbers identify the caller to the person receiving the call. KolaVoice provides a default outbound number, and accounts can also use dedicated KolaVoice-issued numbers.

## List phone numbers

```http theme={null}
GET /phone-numbers
```

The response includes account numbers and the shared default outbound number available to the account.

## Register a KolaVoice number

```http theme={null}
POST /phone-numbers
```

```json theme={null}
{
  "number": "256323200643",
  "country_code": "256",
  "country": "Uganda",
  "agent_id": null
}
```

Only register numbers issued by KolaVoice. The number must be active and outbound-enabled before it can be used for a call or campaign.


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