---
title: "/buy-phone-number"
method: POST
path: "/buy-phone-number"
tags: ["phone-numbers"]
---

# /buy-phone-number

`POST /buy-phone-number`

This will buy a phone number. In the POST request you can either provide the phone number you want to buy, or leave it empty. If the specified `number` is still available, it will be bought or the API will return a failure. Alternatively, if you skipped the `number` field, a random phone number from California (CA) will be bought.

## Request body

- object
  - `number` string — The phone number to purchase, in E.164 format (e.g. "+18058700061"). If not provided, a random US number will be purchased.

## Response `200`

200

- object

## Other responses

- `400` — 400
- `422` — Unprocessable Entity

---

[API](https://skmtc.net/daily/apis/daily-api.md) · [All operations](https://skmtc.net/daily/apis/daily-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/daily/daily-api/revisions/98b9b9a97a33/schema)