---
title: "Get contact verification status for a domain"
method: GET
path: "/v1/registrar/domains/{domain}/contact-verification"
tags: ["domains-registrar"]
---

# Get contact verification status for a domain

`GET /v1/registrar/domains/{domain}/contact-verification`

## Request

- Base URL: `https://api.vercel.com`
- URL: `https://api.vercel.com/v1/registrar/domains/{domain}/contact-verification`
- Auth: HTTP bearer

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.

## Path parameters

- `domain` string, required: A valid domain name

## Query parameters

- `teamId` string

## Response `200`

The registrant contact has been verified.

- union
  - ContactVerified: The registrant contact has been verified.
    - `verified` true, required
  - ContactPendingVerification: The registrant contact has not yet been verified. The contact must be verified by `verifyBy`, and a verification email is sent to `email`.
    - `verified` false, required
    - `verifyBy` string, required: a string to be decoded into a Date
    - `email` string, required

## Other responses

- `400`: There was something wrong with the request
- `401`: Unauthorized
- `403`: Forbidden
- `404`: The domain was not found in our system.
- `429`: TooManyRequests
- `500`: InternalServerError

## Changes

- **2026-07-14** `314022afff45`: 1 info
  - added the optional property `reason` to the response with the `401` status
- **2026-06-22** `7bd30e62d868`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/vercel/apis/api/changes/v1/registrar/domains/:domain/contact-verification/get.md)

---

[API](https://skmtc.dev/vercel/apis/api.md) - [All operations](https://skmtc.dev/vercel/apis/api/llms.txt) - [OpenAPI document](https://skmtc.dev/vercel/apis/api/revisions/4a06e85c2848?raw)