Verify a domain

GEThttps://anjal.app/v1/domains/{domain}/verify

Re-checks DNS records with the upstream ESP. If the domain is now verified, Mission Control atomically adds the new address as a primary alias on the inbox (preserving thread history). The first time this sees the domain verified, the domain.verified webhook fires.

Path parameters

domain

required

string

Fully-qualified domain name

Responses

200application/jsonOK

`domain` string
`status` "pending" \| "verified" \| "failed"	enum: "pending" \| "verified" \| "failed"
`verified` boolean
`dnsRecords` object[]
`type` "TXT" \| "CNAME" \| "MX" \| "A"	enum: "TXT" \| "CNAME" \| "MX" \| "A"
`name` string
`value` string
`priority` integer
`status` "pending" \| "verified"	enum: "pending" \| "verified"
`note` string	Extra instructions for this record. On a shared domain the SPF record is merged into your existing one, and the note says to replace the existing record (a domain must have only one SPF record).
`sharedWith` "google" \| "microsoft" \| "other" \| null	enum: "google" \| "microsoft" \| "other" \| null
`routingSteps` string[]	Present only for shared domains.
`message` string

Authentication

Send your API key in the X-API-Key header (or Authorization: Bearer <key>). Any prefix accepted by this endpoint — tk_, wk_, ak_, or sa_ — is documented in the key prefix table.

Request

import { Anjal } from "anjal";

const client = new Anjal({ apiKey: process.env.MYAGENTMAIL_API_KEY! });

// GET /v1/domains/{domain}/verify
const result = await client.request("get", "/v1/domains/{domain}/verify", { params: { domain: "mail.example.com" } });

Example response · 200

{
  "domain": "string",
  "status": "pending",
  "verified": false,
  "dnsRecords": [
    {
      "type": "TXT",
      "name": "string",
      "value": "string",
      "priority": 0,
      "status": "pending",
      "note": "string"
    }
  ],
  "sharedWith": "google",
  "routingSteps": [
    "string"
  ],
  "message": "string"
}