---
title: "Purchase Phone Number"
method: POST
path: "/user/phone-numbers/purchase"
tags: ["Phone Numbers"]
---

# Purchase Phone Number

`POST /user/phone-numbers/purchase`

## Request

- Base URL: `https://app.famulor.de/api`
- URL: `https://app.famulor.de/api/user/phone-numbers/purchase`
- Auth: HTTP bearer

Purchase a dedicated phone number in Famulor via API. Acquire local, mobile or toll-free numbers for inbound or outbound AI voice agent calls.

[Docs](https://docs.famulor.io/api-v1/phone-numbers/purchase)

## Request body

- object
  - `phone_number` string, required: The phone number to purchase in E.164 format (e.g. +14155551234). Must be a number returned by the Search endpoint.

## Response `201`

Created

- object
  - `message` string: Success message
  - `data` object: The details of the purchased phone number
    - `id` integer: The unique identifier of the phone number
    - `phone_number` string: The phone number in E.164 format
    - `country_code` string: The ISO country code
    - `type` string: The phone number type (always `normal` for purchased numbers)
    - `sms_capable` boolean: Whether the number supports SMS

## Other responses

- `400`: Bad Request
- `401`: Fehlender oder ungültiger API-Key.
- `402`: Payment Required
- `422`: Invalid Format
- `500`: Provider Error

---

[API](https://skmtc.dev/famulor/apis/famulor-api.md) · [All operations](https://skmtc.dev/famulor/apis/famulor-api/llms.txt) · [OpenAPI document](https://skmtc.dev/famulor/apis/famulor-api/revisions/3b938c370721?raw)