latestOpenAPI 3.1.0MIT2026-08-103050171.2 KB

ebcbb377ee0f

Domains

Verify domain

Verify a specific domain for the specified service.

get/services/{serviceId}/domains/{domainName}:verify

Path parameters

serviceIdstring required
Example:01GVRB50KEQFFE1SGMPFRNBG6J

The serviceId containing the domain you want to verify.

domainNamestring required
Example:yourdomain.com

The name of the domain you want to verify.

Response

The verification status of the domain.

Example response

{
  "domains": [
    {
      "message": "Domain DNS records have been updated",
      "domain": {
        "id": "01K8BS9391KGN2Y36CDSNAVHNW",
        "name": "my.domain.com",
        "spamAction": "disabled",
        "state": "active",
        "type": "custom",
        "webPrefix": "email",
        "webScheme": "http",
        "messageTtl": 259200
      },
      "receivingDnsRecords": [
        {
          "priority": 10,
          "recordType": "TXT",
          "valid": "valid",
          "value": "mailgun.org"
        }
      ],
      "sendingDnsRecords": [
        {
          "name": "my.domain.com",
          "recordType": "TXT",
          "valid": "valid",
          "value": "mailgun.org"
        }
      ]
    }
  ]
}