Buy a domain | Vercel REST API

APIs & SDKs

Buy a domain

POSThttps://api.vercel.com/v1/registrar/domains/{domain}/buy

Buy a domain

https://api.vercel.com/v1/registrar/domains/{domain}/buy

const response = await fetch('https://api.vercel.com/v1/registrar/domains/domain/buy?teamId=string', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_ACCESS_TOKEN',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "autoRenew": "true",
    "years": "123",
    "expectedPrice": "123",
    "contactInformation": {
      "firstName": "Example Name",
      "lastName": "Example Name",
      "email": "user@example.com",
      "phone": "string",
      "address1": "string",
      "address2": "string",
      "city": "string",
      "state": "string",
      "zip": "string",
      "country": "string",
      "companyName": "Example Name",
      "fax": "string",
      "additional": {}
    },
    "languageCode": "string"
  }),
});

const data = await response.json();
console.log(data);

Response

{
  "orderId": "example_id",
  "_links": "value"
}

Errors

{
  "status": "400",
  "code": "domain_too_short",
  "message": "string"
}

Authentication

AuthorizationbearerToken

Default authentication mechanism

Path parameters

domainanyRequired

Query parameters

teamIdstringOptional

Body

application/json

autoRenewbooleanRequired

Whether the domain should be auto-renewed before it expires. This can be configured later through the Vercel Dashboard or the Update auto-renew for a domain endpoint.

yearsnumberRequired

The number of years to purchase the domain for.

expectedPricenumberRequired

contactInformationobjectRequired

The contact information for the domain. Some TLDs require additional contact information. Use the Get contact info schema endpoint to retrieve the required fields.

languageCodestringOptional

The language code for the domain. For punycode domains, this must be provided. The list of supported language codes for a TLD can be retrieved from the Get TLD endpoint.

Response

200Success

orderIdstringRequired

A valid order ID

_linksobjectRequired

Errors

400There was something wrong with the request

statusnumberRequired

codestringRequired

messagestringRequired

401Unauthorized

statusnumberRequired

codestringRequired

messagestringRequired

reasonstringOptional

403Forbidden

statusnumberRequired

codestringRequired

messagestringRequired

429TooManyRequests

statusnumberRequired

codestringRequired

messagestringRequired

retryAfterobjectRequired

limitobjectRequired

500InternalServerError

statusnumberRequired

codestringRequired

messagestringRequired

Cross-link map: Buy a domain (/docs/rest-api/domains-registrar/buy-a-domain)

From the Vercel docs graph (built 2026-10-08T05:38:39.548Z), spanning vercel.com docs + KB, nextjs.org, ai-sdk.dev, and other Vercel documentation sites. Full graph as JSON: https://vercel.com/docs/graph.json

Semantically closest pages

Buy multiple domains — POST /v1/registrar/domains/buy — Buy multiple domains at once
Renew a domain — POST /v1/registrar/domains/{domain}/renew — Renew a domain
Transfer-in a domain — POST /v1/registrar/domains/{domain}/transfer — Transfer a domain in from another registrar
Get a domain order — GET /v1/registrar/orders/{orderId} — Get information about a domain order by its ID
Get price data for a domain — GET /v1/registrar/domains/{domain}/price — Get price data for a specific domain

This page links to (1)

Vercel REST API Reference — Interact programmatically with your Vercel account using the SDK or direct HTTP requests.

Pages that link here (2)

By site: vercel-docs (2)

Programmatic Domain Management — Programmatically search, price, purchase, renew, and manage domains with Vercel's domains registrar API endpoints.
Vercel REST API Reference — Interact programmatically with your Vercel account using the SDK or direct HTTP requests.

https://api.vercel.com/v1/registrar/domains/{domain}/buy

const response = await fetch('https://api.vercel.com/v1/registrar/domains/domain/buy?teamId=string', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_ACCESS_TOKEN',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "autoRenew": "true",
    "years": "123",
    "expectedPrice": "123",
    "contactInformation": {
      "firstName": "Example Name",
      "lastName": "Example Name",
      "email": "user@example.com",
      "phone": "string",
      "address1": "string",
      "address2": "string",
      "city": "string",
      "state": "string",
      "zip": "string",
      "country": "string",
      "companyName": "Example Name",
      "fax": "string",
      "additional": {}
    },
    "languageCode": "string"
  }),
});

const data = await response.json();
console.log(data);

Response

{
  "orderId": "example_id",
  "_links": "value"
}

Errors

{
  "status": "400",
  "code": "domain_too_short",
  "message": "string"
}

OpenAPI Specification