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

# Getting a number

If you're on the Free plan, you'll have to head to the [dashboard](https://app.vocode.dev) to buy numbers. The Developer and
Enterprise plans both come with numbers included in the subscription. For more info, see [Pricing](https://vocode.dev/pricing).

<CodeGroup>
  ```python Python theme={null}
  phone_number = vocode_client.numbers.buy_number()
  ```

  ```typescript TypeScript theme={null}
  const phoneNumber = await vocode.numbers.buyNumber();
  ```

  ```bash cURL theme={null}
  curl --request POST \
    --url https://api.vocode.dev/v1/numbers/buy \
    --header 'Content-Type: application/json' \
    --header 'Authorization: Bearer <API_KEY>'
  ```
</CodeGroup>

You'll get a response that looks like:

```json theme={null}
{
  "id": "***",
  "user_id": "***",
  "number": "11234567890",
  "inbound_agent": {...}
}
```

Your phone number is now active! Call the phone number and have a conversation with your AI.
