--- title: transfer-in-a-domain product: vercel url: /docs/rest-api/domains-registrar/transfer-in-a-domain canonical_url: "https://vercel.com/docs/rest-api/domains-registrar/transfer-in-a-domain" last_updated: 2026-08-28 type: reference prerequisites: [] related: - /docs/rest-api summary: Learn about transfer-in-a-domain on Vercel. install_vercel_plugin: npx plugins add vercel/vercel-plugin --- # Transfer-in a domain ```http POST /v1/registrar/domains/{domain}/transfer ``` Transfer a domain in from another registrar ## Authentication **bearerToken**: HTTP bearer ## Path parameters | Name | Type | Required | Description | |---|---|---|---| | `domain` | string | Yes | | ## Query parameters | Name | Type | Required | Description | |---|---|---|---| | `teamId` | string | No | | ## Request body Required: Yes Content-Type: `application/json` ```json { "type": "object", "required": [ "authCode", "autoRenew", "years", "expectedPrice", "contactInformation" ], "properties": { "authCode": { "type": "string", "description": "The auth code for the domain. You must obtain this code from the losing registrar." }, "autoRenew": { "type": "boolean", "description": "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](https://vercel.com/docs/rest-api/reference/endpoints/domains-registrar/update-auto-renew-for-a-domain) endpoint." }, "years": { "type": "number", "description": "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." }, "expectedPrice": { "type": "number", "minimum": 0.01 }, "contactInformation": { "type": "object", "required": [ "firstName", "lastName", "email", "phone", "address1", "city", "state", "zip", "country" ], "properties": { "firstName": { "type": "string", "description": "a non empty string", "pattern": "^\\S[\\s\\S]*\\S$|^\\S$|^$", "minLength": 1 }, "lastName": { "type": "string", "description": "a non empty string", "pattern": "^\\S[\\s\\S]*\\S$|^\\S$|^$", "minLength": 1 }, "email": { "type": "string", "description": "A valid RFC 5322 email address", "minLength": 1 }, "phone": { "type": "string", "description": "A valid E.164 phone number", "pattern": "^(?=(?:\\D*\\d){8,15}$)\\+[1-9]\\d{0,2}\\.?\\d+$", "minLength": 1 }, "address1": { "type": "string", "description": "a non empty string", "pattern": "^\\S[\\s\\S]*\\S$|^\\S$|^$", "minLength": 1 }, "address2": { "type": "string", "description": "a non empty string", "pattern": "^\\S[\\s\\S]*\\S$|^\\S$|^$", "minLength": 1 }, "city": { "type": "string", "description": "a non empty string", "pattern": "^\\S[\\s\\S]*\\S$|^\\S$|^$", "minLength": 1 }, "state": { "type": "string", "description": "a non empty string", "pattern": "^\\S[\\s\\S]*\\S$|^\\S$|^$", "minLength": 1 }, "zip": { "type": "string", "description": "a non empty string", "pattern": "^\\S[\\s\\S]*\\S$|^\\S$|^$", "minLength": 1 }, "country": { "type": "string", "description": "A valid ISO 3166-1 alpha-2 country code" }, "companyName": { "type": "string", "description": "a non empty string", "pattern": "^\\S[\\s\\S]*\\S$|^\\S$|^$", "minLength": 1 }, "fax": { "type": "string", "description": "A valid E.164 phone number", "pattern": "^(?=(?:\\D*\\d){8,15}$)\\+[1-9]\\d{0,2}\\.?\\d+$", "minLength": 1 } } } } } ``` ## Example request ### TypeScript ```typescript 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); ``` ### Next.js ```typescript 'use server'; export async function callEndpoint() { const response = await fetch('https://api.vercel.com/v1/registrar/domains/domain/transfer?teamId=string', { method: 'POST', headers: { 'Authorization': `Bearer ${process.env.VERCEL_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" } }), next: { revalidate: 3600 } }); if (!response.ok) { throw new Error('Request failed'); } return response.json(); } ``` ### cURL ```bash curl -X POST 'https://api.vercel.com/v1/registrar/domains/domain/transfer?teamId=string' \ -H 'Authorization: Bearer YOUR_ACCESS_TOKEN' \ -H 'Content-Type: application/json' \ -d "{ \"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\" } }" ``` ## Example response ```json { "orderId": "example_id", "_links": "value" } ``` ## Responses ### 200: Success Content-Type: `application/json` ```json { "type": "object", "required": [ "orderId", "_links" ], "properties": { "orderId": { "type": "string", "description": "A valid order ID" }, "_links": { "type": "object", "additionalProperties": { "type": "object", "required": [ "href", "method" ], "properties": { "href": { "type": "string" }, "method": { "type": "string", "enum": [ "GET", "POST", "PUT", "DELETE", "PATCH" ] } } } } } } ``` ### 400: There was something wrong with the request Content-Type: `application/json` ```json { "anyOf": [ { "type": "object", "required": [ "status", "code", "message" ], "properties": { "status": { "type": "number", "enum": [ 400 ] }, "code": { "type": "string", "enum": [ "bad_request" ] }, "message": { "type": "string" } } }, { "type": "object", "description": "The domain is already owned by another team or user.", "required": [ "status", "code", "message" ], "properties": { "status": { "type": "number", "enum": [ 400 ] }, "code": { "type": "string", "enum": [ "domain_already_owned" ] }, "message": { "type": "string" } } }, { "type": "object", "description": "The domain name (excluding the TLD) is too short.", "required": [ "status", "code", "message" ], "properties": { "status": { "type": "number", "enum": [ 400 ] }, "code": { "type": "string", "enum": [ "domain_too_short" ] }, "message": { "type": "string" } } }, { "type": "object", "description": "The operation cannot be completed because DNSSEC is enabled for the domain.", "required": [ "status", "code", "message" ], "properties": { "status": { "type": "number", "enum": [ 400 ] }, "code": { "type": "string", "enum": [ "dnssec_enabled" ] }, "message": { "type": "string" } } }, { "type": "object", "description": "The expected price passed does not match the actual price.", "required": [ "status", "code", "message" ], "properties": { "status": { "type": "number", "enum": [ 400 ] }, "code": { "type": "string", "enum": [ "expected_price_mismatch" ] }, "message": { "type": "string" } } }, { "description": "(3 more variants — see OpenAPI spec)" } ] } ``` ### 401: Unauthorized Content-Type: `application/json` ```json { "type": "object", "required": [ "status", "code", "message" ], "properties": { "status": { "type": "number", "enum": [ 401 ] }, "code": { "type": "string", "enum": [ "unauthorized" ] }, "message": { "type": "string" }, "reason": { "type": "string" } } } ``` ### 403: NotAuthorizedForScope Content-Type: `application/json` ```json { "anyOf": [ { "type": "object", "required": [ "status", "code", "message" ], "properties": { "status": { "type": "number", "enum": [ 403 ] }, "code": { "type": "string", "enum": [ "not_authorized_for_scope" ] }, "message": { "type": "string" } } }, { "type": "object", "required": [ "status", "code", "message" ], "properties": { "status": { "type": "number", "enum": [ 403 ] }, "code": { "type": "string", "enum": [ "forbidden" ] }, "message": { "type": "string" } } } ] } ``` ### 429: TooManyRequests Content-Type: `application/json` ```json { "type": "object", "required": [ "status", "code", "message", "retryAfter", "limit" ], "properties": { "status": { "type": "number", "enum": [ 429 ] }, "code": { "type": "string", "enum": [ "too_many_requests" ] }, "message": { "type": "string" }, "retryAfter": { "type": "object", "required": [ "value", "str" ], "properties": { "value": { "type": "number" }, "str": { "type": "string" } } }, "limit": { "type": "object", "required": [ "total", "remaining", "reset" ], "properties": { "total": { "type": "number" }, "remaining": { "type": "number" }, "reset": { "type": "number" } } } } } ``` ### 500: InternalServerError Content-Type: `application/json` ```json { "type": "object", "required": [ "status", "code", "message" ], "properties": { "status": { "type": "number", "enum": [ 500 ] }, "code": { "type": "string", "enum": [ "internal_server_error" ] }, "message": { "type": "string" } } } ``` --- ## Related - [domains-registrar endpoints](/docs/rest-api#domains-registrar) - [REST API overview](/docs/rest-api) - [OpenAPI spec](https://openapi.vercel.sh/) (machine-readable, all endpoints) --- [View full sitemap](/docs/sitemap)