---
title: "Changes to Buy a domain"
method: POST
path: "/v1/registrar/domains/{domain}/buy"
---

# Changes to Buy a domain

`POST /v1/registrar/domains/{domain}/buy`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 7 of 137 revisions.

- **2026-09-15** `dde5ea976005`: 1 info
- **2026-07-14** `314022afff45`: 1 info
- **2026-06-11** `14b4658f819e`: 2 info
- **2026-02-02** `5264f094c3d3`: 250 breaking
- **2026-01-22** `c12186034433`: 1 breaking, 2 warning, 252 info
- **2025-11-28** `45991e5c8b6d`: 2 info
- **2025-10-09** `50caddad4ae7`: 1 info

## Changes

- **2026-09-15** `dde5ea976005`: 1 info
  - added `#/components/schemas/EmojiTldNotSupported` to the response body `anyOf` list for the response status `400`
- **2026-07-14** `314022afff45`: 1 info
  - added the optional property `reason` to the response with the `401` status
- **2026-06-11** `14b4658f819e`: 2 info
  - added the new optional request property `languageCode`
  - added `#/components/schemas/LanguageCodeRequired` to the response body `anyOf` list for the response status `400`
- **2026-02-02** `5264f094c3d3`: 250 breaking
  - removed the enum value `AD` of the request property `contactInformation/country`
  - removed the enum value `AE` of the request property `contactInformation/country`
  - removed the enum value `AF` of the request property `contactInformation/country`
  - removed the enum value `AG` of the request property `contactInformation/country`
  - removed the enum value `AI` of the request property `contactInformation/country`
  - removed the enum value `AL` of the request property `contactInformation/country`
  - removed the enum value `AM` of the request property `contactInformation/country`
  - removed the enum value `AO` of the request property `contactInformation/country`
  - removed the enum value `AQ` of the request property `contactInformation/country`
  - removed the enum value `AR` of the request property `contactInformation/country`
  - removed the enum value `AS` of the request property `contactInformation/country`
  - removed the enum value `AT` of the request property `contactInformation/country`
  - removed the enum value `AU` of the request property `contactInformation/country`
  - removed the enum value `AW` of the request property `contactInformation/country`
  - removed the enum value `AX` of the request property `contactInformation/country`
  - removed the enum value `AZ` of the request property `contactInformation/country`
  - removed the enum value `BA` of the request property `contactInformation/country`
  - removed the enum value `BB` of the request property `contactInformation/country`
  - removed the enum value `BD` of the request property `contactInformation/country`
  - removed the enum value `BE` of the request property `contactInformation/country`
  - removed the enum value `BF` of the request property `contactInformation/country`
  - removed the enum value `BG` of the request property `contactInformation/country`
  - removed the enum value `BH` of the request property `contactInformation/country`
  - removed the enum value `BI` of the request property `contactInformation/country`
  - removed the enum value `BJ` of the request property `contactInformation/country`
  - removed the enum value `BL` of the request property `contactInformation/country`
  - removed the enum value `BM` of the request property `contactInformation/country`
  - removed the enum value `BN` of the request property `contactInformation/country`
  - removed the enum value `BO` of the request property `contactInformation/country`
  - removed the enum value `BQ` of the request property `contactInformation/country`
  - removed the enum value `BR` of the request property `contactInformation/country`
  - removed the enum value `BS` of the request property `contactInformation/country`
  - removed the enum value `BT` of the request property `contactInformation/country`
  - removed the enum value `BV` of the request property `contactInformation/country`
  - removed the enum value `BW` of the request property `contactInformation/country`
  - removed the enum value `BY` of the request property `contactInformation/country`
  - removed the enum value `BZ` of the request property `contactInformation/country`
  - removed the enum value `CA` of the request property `contactInformation/country`
  - removed the enum value `CC` of the request property `contactInformation/country`
  - removed the enum value `CD` of the request property `contactInformation/country`
  - …210 more
- **2026-01-22** `c12186034433`: 1 breaking, 2 warning, 252 info
  - request property `contactInformation/country` was restricted to a list of enum values
  - changed the pattern of the request property `contactInformation/fax` from `^(?=(?:\D*\d){7,15}$)\+[1-9]\d{0,2}\.?\d+$` to `^(?=(?:\D*\d){8,15}$)\+[1-9]\d{0,2}\.?\d+$`
  - changed the pattern of the request property `contactInformation/phone` from `^(?=(?:\D*\d){7,15}$)\+[1-9]\d{0,2}\.?\d+$` to `^(?=(?:\D*\d){8,15}$)\+[1-9]\d{0,2}\.?\d+$`
  - added the new `AD` enum value to the request property `contactInformation/country`
  - added the new `AE` enum value to the request property `contactInformation/country`
  - added the new `AF` enum value to the request property `contactInformation/country`
  - added the new `AG` enum value to the request property `contactInformation/country`
  - added the new `AI` enum value to the request property `contactInformation/country`
  - added the new `AL` enum value to the request property `contactInformation/country`
  - added the new `AM` enum value to the request property `contactInformation/country`
  - added the new `AO` enum value to the request property `contactInformation/country`
  - added the new `AQ` enum value to the request property `contactInformation/country`
  - added the new `AR` enum value to the request property `contactInformation/country`
  - added the new `AS` enum value to the request property `contactInformation/country`
  - added the new `AT` enum value to the request property `contactInformation/country`
  - added the new `AU` enum value to the request property `contactInformation/country`
  - added the new `AW` enum value to the request property `contactInformation/country`
  - added the new `AX` enum value to the request property `contactInformation/country`
  - added the new `AZ` enum value to the request property `contactInformation/country`
  - added the new `BA` enum value to the request property `contactInformation/country`
  - added the new `BB` enum value to the request property `contactInformation/country`
  - added the new `BD` enum value to the request property `contactInformation/country`
  - added the new `BE` enum value to the request property `contactInformation/country`
  - added the new `BF` enum value to the request property `contactInformation/country`
  - added the new `BG` enum value to the request property `contactInformation/country`
  - added the new `BH` enum value to the request property `contactInformation/country`
  - added the new `BI` enum value to the request property `contactInformation/country`
  - added the new `BJ` enum value to the request property `contactInformation/country`
  - added the new `BL` enum value to the request property `contactInformation/country`
  - added the new `BM` enum value to the request property `contactInformation/country`
  - added the new `BN` enum value to the request property `contactInformation/country`
  - added the new `BO` enum value to the request property `contactInformation/country`
  - added the new `BQ` enum value to the request property `contactInformation/country`
  - added the new `BR` enum value to the request property `contactInformation/country`
  - added the new `BS` enum value to the request property `contactInformation/country`
  - added the new `BT` enum value to the request property `contactInformation/country`
  - added the new `BV` enum value to the request property `contactInformation/country`
  - added the new `BW` enum value to the request property `contactInformation/country`
  - added the new `BY` enum value to the request property `contactInformation/country`
  - added the new `BZ` enum value to the request property `contactInformation/country`
  - …215 more
- **2025-11-28** `45991e5c8b6d`: 2 info
  - added the new optional `query` request parameter `teamId`
  - added `#/components/schemas/DomainTooShort` to the response body `anyOf` list for the response status `400`
- **2025-10-09** `50caddad4ae7`: 1 info
  - endpoint added

---

[Operation](https://skmtc.dev/vercel/apis/api/docs/v1/registrar/domains/:domain/buy/post.md) - [API](https://skmtc.dev/vercel/apis/api.md) - [Page](https://skmtc.dev/vercel/apis/api/changes/v1/registrar/domains/:domain/buy/post)
