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

# List domains

`GET /v1/domains`

## Request

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

Every sending domain in the project, each with its verification state and the DNS records to publish.

Unpaginated. Only domains reaching `verified` can send; until then a send from an address on them is refused with 403.

## Response `200`

All domains with their DNS records.

- object
  - `data` Domain[], required
    - `domainId` string, required
    - `projectId` string
    - `domain` string, required
    - `status` 'pending' | 'verified' | 'failed', required
    - `dkimStatus` 'pending' | 'verified' | 'failed' | 'not_applicable'
    - `spfStatus` 'pending' | 'verified' | 'failed'
    - `dmarcStatus` 'pending' | 'verified' | 'failed'
    - `trackingStatus` 'pending' | 'verified' | 'failed'
    - `mailFromStatus` 'pending' | 'verified' | 'failed' | 'not_applicable': Custom MAIL FROM subdomain (`bounce.<domain>`) — carries the bounce path and lets DMARC align SPF.
    - `mailFromDomain` string, nullable
    - `selector` string, nullable: DKIM selector published at `<selector>._domainkey.<domain>`.
    - `verifiedForSending` boolean: Whether the provider will currently accept mail from this domain.
    - `dkimTokens` string[]: Legacy SES Easy DKIM CNAME tokens. Empty for domains onboarded with BYODKIM, which publish a single TXT record instead.
    - `verificationToken` string, nullable
    - `lastCheckedAt` string, date-time, nullable
    - `createdAt` string, date-time, required
    - `dnsRecords` DnsRecord[], required: The DNS records to install.
      - `purpose` 'ownership' | 'dkim' | 'spf' | 'dmarc' | 'tracking' | 'mailfrom', required
      - `type` 'TXT' | 'CNAME' | 'MX', required
      - `host` string, required
      - `value` string, required
      - `status` 'pending' | 'verified' | 'failed' | 'not_applicable', required

## Other responses

- `401`: Missing or invalid API key.

---

[API](https://skmtc.dev/volanea/apis/volanea-api.md) · [All operations](https://skmtc.dev/volanea/apis/volanea-api/llms.txt) · [OpenAPI document](https://skmtc.dev/volanea/apis/volanea-api/revisions/9e187ae84fda?raw)