---
title: "Changes to Purchase phone number"
method: POST
path: "/v1/phone-numbers/purchase"
---

# Changes to Purchase phone number

`POST /v1/phone-numbers/purchase`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 5 of 113 revisions.

- **2026-09-25** `2c04683ce694`: 3 info
- **2026-09-23** `dd3865482f9f`: 1 warning
- **2026-09-18** `eded32b62823`: 1 warning
- **2026-09-17** `be448f13ecdc`: 1 info
- **2026-09-10** `e70ed06e7150`: 1 warning, 1 info

## Changes

- **2026-09-25** `2c04683ce694`: 3 info
  - added the new optional request property `claimId`
  - added the optional property `code` to the response with the `401` status
  - added the optional property `details` to the response with the `401` status
- **2026-09-23** `dd3865482f9f`: 1 warning
  - added the new `NO_WHATSAPP_ELIGIBLE_NUMBER` enum value to the `code` response property for the response status `409`
- **2026-09-18** `eded32b62823`: 1 warning
  - added the new `COUNTRY_OUT_OF_STOCK` enum value to the `code` response property for the response status `409`
- **2026-09-17** `be448f13ecdc`: 1 info
  - added the non-success response with the status `503`
- **2026-09-10** `e70ed06e7150`: 1 warning, 1 info
  - added the new `PHONE_NUMBER_UNAVAILABLE` enum value to the `code` response property for the response status `409`
  - added the new optional request property `phoneNumber`

---

[Operation](https://skmtc.dev/zernio/apis/zernio-api/docs/v1/phone-numbers/purchase/post.md) · [API](https://skmtc.dev/zernio/apis/zernio-api.md) · [Page](https://skmtc.dev/zernio/apis/zernio-api/changes/v1/phone-numbers/purchase/post)