Skip to content
Docs

Transfer-in a domain

POSThttps://api.vercel.com/v1/registrar/domains/{domain}/transfer
Transfer a domain in from another registrar
Request
import { Vercel } from "@vercel/sdk";


const vercel = new Vercel({
  bearerToken: "<YOUR_BEARER_TOKEN_HERE>",
});


async function run() {
  const result = await vercel.domainsRegistrar.transferInDomain({
    domain: "silky-fund.org",
    teamId: "team_1a2b3c4d5e6f7g8h9i0j1k2l",
    requestBody: {
      authCode: "<value>",
      autoRenew: true,
      years: 298.08,
      expectedPrice: 5092.5,
      contactInformation: {
        firstName: "Gabrielle",
        lastName: "Hackett",
        email: "Keshawn99@yahoo.com",
        phone: "(758) 385-1802 x13762",
        address1: "<value>",
        city: "Pattiestead",
        state: "Idaho",
        zip: "64653-9022",
        country: "JO",
      },
    },
  });


  console.log(result);
}


run();
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
403NotAuthorizedForScope
statusnumberRequired
codestringRequired
messagestringRequired
429TooManyRequests
statusnumberRequired
codestringRequired
messagestringRequired
retryAfterobjectRequired
limitobjectRequired
500InternalServerError
statusnumberRequired
codestringRequired
messagestringRequired