API reference

Get a sending domain

Returns a single sending domain including its full DNS records for display.

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

Authenticate with a session token and X-Tenant-Slug. Required role: any member.

Request

curl
curl https://api-raven-cloud.autotribes.app/v1/admin/sending-domains/9b1c2d3e-4f5a-6b7c-8d9e-0f1a2b3c4d5e \
  -H "Authorization: Bearer eyJ..." \
  -H "X-App-Name: raven-cloud" \
  -H "X-Tenant-Slug: acme-co"

Response

200 OK

json
{
  "id": "9b1c2d3e-4f5a-6b7c-8d9e-0f1a2b3c4d5e",
  "domain": "mail.acme.co.ke",
  "status": "verified",
  "verifiedAt": "2026-05-01T10:45:00.000Z",
  "createdAt": "2026-05-01T10:23:18.114Z",
  "dnsRecords": {
    "dkim": {
      "type": "TXT",
      "name": "raven._domainkey.mail.acme.co.ke",
      "value": "v=DKIM1; k=rsa; p=MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEA...",
      "verified": true
    },
    "spf": {
      "type": "TXT",
      "name": "mail.acme.co.ke",
      "value": "v=spf1 include:spf.nudgel.ai ~all",
      "verified": true
    },
    "dmarc": {
      "type": "TXT",
      "name": "_dmarc.mail.acme.co.ke",
      "value": "v=DMARC1; p=quarantine; rua=mailto:dmarc@mail.acme.co.ke",
      "verified": true
    }
  }
}

Errors

StatusWhen
401Invalid or expired session token
403Domain belongs to a different tenant
404Domain ID does not exist