Verify Account Domain

This document contains details for the /api/v1/account/{accountUuid}/domain/{domainUuid}/verify endpoint, including the request body and response example for domain verification.

Use this endpoint to choose the domain verification method and get the DNS values required for verification.

Request domain verification

Endpoint
Method	PATCH
Request URL	/api/v1/account/{accountUuid}/domain/{domainUuid}/verify
Headers
Authorization *	Bearer TOKEN
Content-Type	application/json
Request
accountUuid *	Target account UUID
domainUuid *	Account domain UUID
Body *	{ "method": "string" }

Request example

{
  "method": "DNS_CNAME_RECORD"
}

Response example

This response returns the verification data you must add to DNS. This step does not activate the domain.

{
    "uuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "accountUuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "domain": "google.com",
    "status": "UNVERIFIED",
    "verifyInfo" : {
        "domain": "_whitedoc-verify",
        "value": "abc123"
    },
    "verifyMethod": "DNS_TXT_RECORD"
}

Add verifyInfo.domain and verifyInfo.value to DNS, then continue with Confirm Account Domain Verification.

Response status codes

Code	Description
200	Success
400	Bad request
401	Not authorized
403	Forbidden
404	Domain not found

Related topics

• Confirm Account Domain Verification

• Domain Statuses & Verify Methods

• Add Account Domain