---
title: "Changes to Purchase a phone number"
method: POST
path: "/numbers/phones"
---

# Changes to Purchase a phone number

`POST /numbers/phones`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 2 of 68 revisions.

- **2026-10-16** `4ad548c528a8`: 5 breaking, 2 warning, 11 info
- **2026-08-13** `a1453ac769d4`: 1 info

## Changes

- **2026-10-16** `4ad548c528a8`: 5 breaking, 2 warning, 11 info
  - removed the required property `anyOf[#/components/schemas/NumberErrorResponse]/reason` from the response with the `503` status
  - removed the required property `anyOf[#/components/schemas/NumberErrorResponse]/success` from the response with the `503` status
  - removed the required property `anyOf[#/components/schemas/PublicPhonePurchaseError]/reason` from the response with the `503` status
  - removed the required property `reason` from the response with the `409` status
  - removed the required property `reason` from the response with the `422` status
  - deleted the `header` request parameter `Idempotency-Key`
  - removed the request property `purpose`
  - added the new optional `header` request parameter `idempotency-key`
  - added the new optional request property `label`
  - added the new `included_only` enum value to the request property `billingPreference`
  - added the media type `application/json` for the response with the status `400`
  - added the media type `application/json` for the response with the status `401`
  - added the media type `application/json` for the response with the status `500`
  - added the optional property `anyOf[#/components/schemas/NumberErrorResponse]/details` to the response with the `503` status
  - added the required property `anyOf[#/components/schemas/NumberErrorResponse]/code` to the response with the `503` status
  - added the required property `anyOf[#/components/schemas/PublicPhonePurchaseError]/code` to the response with the `503` status
  - added the required property `code` to the response with the `409` status
  - added the required property `code` to the response with the `422` status
- **2026-08-13** `a1453ac769d4`: 1 info
  - endpoint added

---

[Operation](https://skmtc.dev/droidrun/apis/droidrun-cloud/docs/numbers/phones/post.md) - [API](https://skmtc.dev/droidrun/apis/droidrun-cloud.md) - [Page](https://skmtc.dev/droidrun/apis/droidrun-cloud/changes/numbers/phones/post)