v52

latestOpenAPI 3.0.0raw.githubusercontent.com2026-08-03269339953.6 KB
Reach: Profiles

Get profile domain DNS status

Retrieve the DNS configuration status for a profile's domain.

This endpoint reports the state of MX, SPF, DKIM and DMARC records, including the actual records found and the suggested records required for correct email delivery.

get/api/reach/v1/profiles/{profileUuid}/domains/dns-status

Path parameters

profileUuidstring required
Example:550e8400-e09b-41d4-a716-400055000000

Profile uuid parameter

Response

Success response

domainstring

Example response

{
  "domain": "example.com",
  "mx": {
    "actual": [
      {
        "type": "MX",
        "value": "mx1.example.com"
      }
    ],
    "suggested": [
      {
        "name": "@",
        "type": "MX",
        "value": "mx1.example.com"
      }
    ],
    "is_valid": true
  },
  "spf": {
    "actual": [
      {
        "type": "MX",
        "value": "mx1.example.com"
      }
    ],
    "suggested": [
      {
        "name": "@",
        "type": "MX",
        "value": "mx1.example.com"
      }
    ],
    "is_valid": true
  },
  "dkim": {
    "actual": [
      {
        "type": "MX",
        "value": "mx1.example.com"
      }
    ],
    "suggested": [
      {
        "name": "@",
        "type": "MX",
        "value": "mx1.example.com"
      }
    ],
    "is_valid": true
  },
  "dmarc": {
    "actual": [
      {
        "type": "MX",
        "value": "mx1.example.com"
      }
    ],
    "suggested": [
      {
        "name": "@",
        "type": "MX",
        "value": "mx1.example.com"
      }
    ],
    "is_valid": true
  }
}