---
title: "List email sender domains"
method: GET
path: "/email-domains"
tags: ["Domains"]
---

# List email sender domains

`GET /email-domains`

## Request

- Base URL: `https://api.cavuno.com/v1`
- URL: `https://api.cavuno.com/v1/email-domains`
- Auth: HTTP bearer

Returns the custom email sender domain for your board. A board has at most one, so the list holds zero or one item.

## Response `200`

Successful response.

- object
  - `object` 'list', required
  - `url` string, required
  - `hasMore` boolean, required
  - `nextCursor` string, nullable, required
  - `data` EmailDomain[], required
    - `id` string, required
    - `object` 'email_domain', required
    - `domain` string, required: The sending hostname.
    - `status` 'pending' | 'verified' | 'failed', required: `pending` until the required DNS records verify, `verified` once board email sends from this domain, `failed` when the last check found a problem (see `statusReason`; publish or fix the records and verify again).
    - `senderName` string, required
    - `senderLocalPart` string, required
    - `senderAddress` string, required: The From address once the domain is verified.
    - `dnsRecords` EmailDomainDnsRecord[], required: Records to publish at the domain’s DNS provider. Empty while the domain is still being set up with the email provider; call verify to retry.
      - `purpose` 'dkim' | 'return_path' | 'dmarc', required: `dkim` signs outgoing mail, `return_path` receives bounces and complaints, `dmarc` is an optional policy record.
      - `type` string, required: DNS record type, for example `CNAME` or `TXT`.
      - `name` string, required: Host to create the record on, relative to the DNS zone the domain lives in (`@` is the zone itself), as most DNS providers expect it typed.
      - `value` string, required: Exact value to publish.
      - `ttl` string, required: Suggested TTL. `Auto` means the DNS provider’s default.
      - `required` boolean, required: Whether the domain needs this record to send. DMARC is recommended but optional.
      - `status` string, required: Last check of this record: `pending`, `verified`, or `failed`.
    - `statusReason` 'setup_required' | 'dns_verification_failed', nullable, required: Why the last check failed, when it did. `setup_required`: the domain must be set up with the email provider again; call verify, which re-stages it and returns fresh DNS records. `dns_verification_failed`: the published records do not match yet; check each record’s `status`, fix them and verify again.
    - `verifiedAt` string, nullable, required
    - `lastCheckedAt` string, nullable, required
    - `createdAt` string, required

## Other responses

- `default`: An error. Every non-2xx response uses the same envelope; see the Errors section of the introduction.

## Changes

- **2026-10-19** `c34152c38176`: 1 info
  - added the optional property `error/upgrade` to the response with the `default` status

[Operation history](https://skmtc.dev/cavuno/apis/cavuno-v1-rest-api/changes/email-domains/get.md)

---

[API](https://skmtc.dev/cavuno/apis/cavuno-v1-rest-api.md) · [All operations](https://skmtc.dev/cavuno/apis/cavuno-v1-rest-api/llms.txt) · [OpenAPI document](https://skmtc.dev/cavuno/apis/cavuno-v1-rest-api/revisions/d5974dabff14?raw)