---
title: "Request domain verification"
method: POST
path: "/api/v1/org/domains/verify"
tags: ["Organizations"]
---

# Request domain verification

`POST /api/v1/org/domains/verify`

Sends a one-time passcode to an address at the domain to begin verifying
ownership. The domain must not be a public email provider and must not
already be verified by another organization.

## Request body

- RequestDomainVerification — Request to verify a domain. `challengeEmail` must be an address at `domain`; a one-time passcode is sent there and confirmed via {@link ConfirmDomainVerification}.
  - `challengeEmail` string, required
  - `domain` string, required

## Response `200`

Ok

- ApiDomainVerificationStatusResponse
  - `results` DomainVerificationStatus, required — Verification status of a single domain. Mirrors {@link EmailStatusExpiring}: `otp` is present only while a pending one-time passcode challenge exists.
    - `otp` object — One time passcode information If there is no active passcode, this will be undefined
      - `numberOfAttempts` number, double, required — Number of times the passcode has been attempted
      - `createdAt` string, date-time, required — Time that the passcode was created
      - `isMaxAttempts` boolean, required
      - `isExpired` boolean, required
      - `expiresAt` string, date-time, required
    - `isVerified` boolean, required
    - `domain` string, required
  - `status` 'ok', required

## Other responses

- `default` — Error

---

[API](https://skmtc.net/lightdash/apis/lightdash-api.md) · [All operations](https://skmtc.net/lightdash/apis/lightdash-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/lightdash/lightdash-api/versions/40c933755c9a/schema)