API reference

List domain verifications

Returns all provider verifications for a sending domain, including current DNS check state and any per-record DNS data. Required role: admin or owner.

GET/v1/admin/sending-domains/:id/verifications

Authenticate with a session token and X-Tenant-Slug. Required role: admin or owner.

Request

curl

curl https://api-raven-cloud.autotribes.app/v1/admin/sending-domains/$DOMAIN_ID/verifications \
  -H "Authorization: Bearer $TOKEN" \
  -H "X-Tenant-Slug: my-tenant"

Response

200 OK — array of verification objects.

json

[
  {
    "id": "verification-uuid",
    "provider": "postmark",
    "providerConfigId": "uuid",
    "registrationState": "registered",
    "providerDomainId": "12345",
    "verificationState": "verified",
    "dnsRecords": [
      {
        "type": "TXT",
        "host": "20240501._domainkey.mail.example.co.ke",
        "value": "v=DKIM1; k=rsa; p=...",
        "note": "DKIM signing key"
      },
      {
        "type": "CNAME",
        "host": "pm-bounces.mail.example.co.ke",
        "value": "pm.mtasv.net",
        "note": "Return-Path for bounce processing"
      }
    ],
    "registrationError": null,
    "lastCheckedAt": "2026-05-01T12:05:00Z",
    "lastCheckError": null,
    "verifiedAt": "2026-05-01T12:05:00Z",
    "attachedAt": "2026-05-01T12:00:01Z"
  }
]

Use cases

POLLING AND CUSTOM DASHBOARDS

This endpoint is designed for two patterns:

Status polling — call from an external script every 30 s after publishing DNS records until verificationState reaches verified.
Custom dashboards — build your own DNS record display or verification status widget on top of Nudgel, using the raw dnsRecords array.

The Nudgel admin UI uses this same endpoint to populate the per-provider tabs on the domain detail page.

Field	Values
`registrationState`	`pending` · `registered` · `failed`
`verificationState`	`pending_dns` · `verified` · `failed`

Errors

Status	When
`401`	Invalid or expired session token
`403`	Caller does not have admin or owner role
`404`	Sending domain not found for this tenant