---
title: "Check DNS and provider setup again"
method: POST
path: "/v1/account/email_domains/{domain_id}/verify"
tags: ["Email domains"]
---

# Check DNS and provider setup again

`POST /v1/account/email_domains/{domain_id}/verify`

## Request

- Base URL: `https://api.revdoku.com`
- URL: `https://api.revdoku.com/v1/account/email_domains/{domain_id}/verify`
- Auth: HTTP bearer

Queues the check and returns the current state. Read the domain again to see the result.

## Path parameters

- `domain_id` string, required

## Request body

- object
  - `account_id` string: Select another granted account for this request.
  - `reason` string, nullable: Optional purpose for this action. AI agents should explain intentional reads and changes when known; omit when unknown. Do not include secrets, file contents, or transcripts.

## Response `202`

Accepted

- object
  - `success` true, required
  - `data` object, required
    - `domain` EmailDomain, required
      - `suggested_subdomain` string, nullable
      - `root_guidance` string, nullable
      - `pause_reason` string, nullable
      - `id` string, required
      - `hostname` string, required
      - `status` string, required
      - `guidance` string
      - `receiving` boolean
      - `root_domain` boolean
      - `paused_at` string, date-time, nullable
      - `last_checked_at` string, date-time, nullable
      - `ownership_verified_at` string, date-time, nullable
      - `setup_expires_at` string, date-time, nullable
      - `ready_at` string, date-time, nullable
      - `required_dns_records` DnsRecord[]
        - `type` string, required
        - `name` string, required
        - `value` string, required
        - `purpose` string, required
        - `zone` string, required
        - `relative_name` string, required
      - `error` object, nullable
        - `code` string
        - `message` string
        - `retryable` boolean
      - `assigned_mailboxes` object[]
        - `id` string
        - `email` object
          - `address` string

## Other responses

- `default`: Request failed. See error.code. Any 429 or 503 response with Retry-After (for example 503 EMAIL_LABELING_PENDING or 503 EMAIL_INDEX_BUILDING): wait that many seconds, then try the read again. 429 EMAIL_SEND_RATE_LIMITED has no Retry-After. Never retry EMAIL_LOOP_DETECTED.

---

[API](https://skmtc.dev/revdoku/apis/revdoku-api.md) · [All operations](https://skmtc.dev/revdoku/apis/revdoku-api/llms.txt) · [OpenAPI document](https://skmtc.dev/revdoku/apis/revdoku-api/revisions/3ff4e2540a8b?raw)