Domains API

Domain creation, DNS setup, and verification are performed from the dashboard. The developer API exposes a read-only listing so integrations can discover which verified domains they are allowed to send from.

List Domains

GET /api/v1/domains
Authorization: Bearer {api_key}

Required scope: domain:read. Keys with all_domains = false only see domains in their allowlist.

Response

[
  {
    "id": "domain_uuid_1",
    "name": "mail.yourdomain.com",
    "status": "verified",
    "verified_at": "2026-03-01T09:00:00Z"
  }
]