Transfer-in a domain | Vercel REST API

APIs & SDKs

Transfer-in a domain

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

Transfer a domain in from another registrar

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

const response = await fetch('https://api.vercel.com/v1/registrar/domains/domain/transfer?teamId=string', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_ACCESS_TOKEN',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "authCode": "string",
    "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"
    }
  }),
});

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

Response

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

Errors

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

Authentication

AuthorizationbearerToken

Default authentication mechanism

Path parameters

domainanyRequired

Query parameters

teamIdstringOptional

Body

application/json

authCodestringRequired

The auth code for the domain. You must obtain this code from the losing registrar.

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 renew the domain for once it is transferred in. This must be a valid number of transfer years for the TLD.

expectedPricenumberRequired

contactInformationobjectRequired

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: Transfer-in a domain (/docs/rest-api/domains-registrar/transfer-in-a-domain)

From the Vercel docs graph (built 2026-10-05T05:39:47.698Z), 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 a domain — POST /v1/registrar/domains/{domain}/buy — Buy a domain
Get a domain's transfer status — GET /v1/registrar/domains/{domain}/transfer — Get the transfer status for a domain
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
Get the auth code for a domain — GET /v1/registrar/domains/{domain}/auth-code — Get the auth code for a domain. This is required to transfer a domain fro

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}/transfer

const response = await fetch('https://api.vercel.com/v1/registrar/domains/domain/transfer?teamId=string', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_ACCESS_TOKEN',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "authCode": "string",
    "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"
    }
  }),
});

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

Response

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

Errors

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

OpenAPI Specification