---
title: "Verify Domain"
method: POST
path: "/v1/domains/{domain}/verify"
tags: ["Domains"]
---

# Verify Domain

`POST /v1/domains/{domain}/verify`

Trigger DNS verification for a domain. Returns current verification status. Requires API key with domain:write.

## Path parameters

- `domain` string, required

## Response `200`

Verification result

- ApiResponseDomainVerification
  - `success` boolean, required
  - `data` object, nullable
    - `domain` string
    - `status` 'verified' | 'degraded' | 'verifying' | 'failed' | 'pending'
    - `dkimStatus` string
    - `mailFromStatus` string
    - `dnsRecords` DnsRecord[]
      - `type` 'CNAME' | 'TXT' | 'MX'
      - `name` string
      - `value` string
      - `priority` integer
      - `status` 'pending' | 'verified' | 'failed'
    - `allVerified` boolean
    - `dnsIssues` string[]
    - `connectUrl` string, uri, nullable — Link to open the domain in Migma and start one-click DNS setup when the domain cannot send yet
  - `error` string, nullable

## Other responses

- `401` — Unauthorized
- `404` — Resource not found

## Changes

- **2026-10-03** `3559ca4c97d3` — 1 info
  - added the optional property `allOf[subschema #2]/data/connectUrl` to the response with the `200` status

[Change history](https://skmtc.dev/migma/apis/migma-ai-api-v1/changes/v1/domains/:domain/verify/post.md)

---

[API](https://skmtc.dev/migma/apis/migma-ai-api-v1.md) · [All operations](https://skmtc.dev/migma/apis/migma-ai-api-v1/llms.txt) · [OpenAPI document](https://skmtc.dev/migma/apis/migma-ai-api-v1/revisions/3559ca4c97d3?raw)