API reference

List sending domains

Returns all sending domains registered for the active tenant.

GET/v1/admin/sending-domains

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 \
  -H "Authorization: Bearer eyJ..." \
  -H "X-App-Name: raven-cloud" \
  -H "X-Tenant-Slug: acme-co"

Response

200 OK

json

{
  "data": [
    {
      "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"
    },
    {
      "id": "a1b2c3d4-e5f6-7a8b-9c0d-e1f2a3b4c5d6",
      "domain": "notifications.acme.co.ke",
      "status": "pending",
      "verifiedAt": null,
      "createdAt": "2026-05-01T11:00:00.000Z"
    }
  ],
  "total": 2
}

Errors

Status	When
`401`	Invalid or expired session token
`403`	Tenant slug header missing or caller is not a member of the tenant