Get contact verification status for a domain

APIs & SDKs

GEThttps://api.vercel.com/v1/registrar/domains/{domain}/contact-verification

Get the registrant contact verification status for a domain. Use this after purchasing a domain to determine whether the contact has been verified. Note that a bought_too_recently error will be returned if the domain was bought less than 30 minutes before the request.

https://api.vercel.com/v1/registrar/domains/{domain}/contact-verification

const response = await fetch('https://api.vercel.com/v1/registrar/domains/domain/contact-verification?teamId=string', {
  method: 'GET',
  headers: {
    'Authorization': 'Bearer YOUR_ACCESS_TOKEN',
    'Content-Type': 'application/json',
  },
});

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

Response

{
  "verified": "true"
}

Errors

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

Authentication

AuthorizationbearerToken

Default authentication mechanism

Path parameters

domainanyRequired

Query parameters

teamIdstringOptional

Response

200The registrant contact has been verified.

verifiedbooleanRequired

Errors

400There was something wrong with the request

statusnumberRequired

codestringRequired

messagestringRequired

401Unauthorized

statusnumberRequired

codestringRequired

messagestringRequired

reasonstringOptional

403Forbidden

statusnumberRequired

codestringRequired

messagestringRequired

404The domain was not found in our system.

statusnumberRequired

codestringRequired

messagestringRequired

429TooManyRequests

statusnumberRequired

codestringRequired

messagestringRequired

retryAfterobjectRequired

limitobjectRequired

500InternalServerError

statusnumberRequired

codestringRequired

messagestringRequired

Cross-link map: Get contact verification status for a domain (/docs/rest-api/domains-registrar/get-contact-verification-status-for-a-domain)

From the Vercel docs graph (built 2026-10-10T05:32:43.016Z), 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

Get a domain's transfer status — GET /v1/registrar/domains/{domain}/transfer — Get the transfer status for 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
Get contact info schema — GET /v1/registrar/domains/{domain}/contact-info/schema — Some TLDs require additional contact information. Use this endp
Buy a domain — POST /v1/registrar/domains/{domain}/buy — Buy a domain
Get Domain Availability and Pricing — POST /v1/registrar/domains/search — Start domain research here. Get registration availability and pricing for 1–200 exac

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 (1)

By site: vercel-docs (1)

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}/contact-verification

const response = await fetch('https://api.vercel.com/v1/registrar/domains/domain/contact-verification?teamId=string', {
  method: 'GET',
  headers: {
    'Authorization': 'Bearer YOUR_ACCESS_TOKEN',
    'Content-Type': 'application/json',
  },
});

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

Response

{
  "verified": "true"
}

Errors

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

OpenAPI Specification