---
title: "GET /domains"
method: GET
path: "/domains"
---

# GET /domains

`GET /domains`

## Request

- Base URL: `https://api.useanima.sh/v1`
- URL: `https://api.useanima.sh/v1/domains`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-API-Key`

## Response `200`

OK

- object: Domain list response
  - `items` object[], required: List of domains
    - `id` string, required: Unique identifier of the domain
    - `domain` string, required: Fully qualified domain name
    - `status` 'NOT_STARTED' | 'PENDING' | 'VERIFYING' | 'VERIFIED' | 'INVALID' | 'FAILED', required: Current verification status
    - `verified` boolean, required: Whether the domain has been fully verified
    - `verificationCooldownUntil` string, date-time, nullable, required: Earliest time a re-verification can be attempted, or null if no cooldown
    - `verificationToken` string, required: Token value to place in DNS records for verification
    - `verificationMethod` 'DNS_TXT' | 'DNS_CNAME', required: DNS record method used for domain verification
    - `dkimSelector` string, nullable, required: DKIM selector used for email signing, or null if not configured
    - `dkimPublicKey` string, nullable, required: DKIM public key for DNS publication, or null if not configured
    - `spfConfigured` boolean, required: Whether SPF DNS records are correctly configured
    - `dmarcConfigured` boolean, required: Whether DMARC DNS records are correctly configured
    - `mxConfigured` boolean, required: Whether MX DNS records are correctly configured
    - `feedbackEnabled` boolean, required: Whether bounce and complaint feedback processing is enabled
    - `records` object[], nullable, required: Required DNS records for this domain, or null if not yet generated
      - `type` 'TXT' | 'CNAME' | 'MX', required: DNS record type
      - `name` string, required: DNS record hostname
      - `value` string, required: Expected DNS record value
      - `priority` integer: MX record priority (only applicable for MX records)
      - `status` 'MISSING' | 'INVALID' | 'VALID', required: Current validation status of this DNS record
    - `createdAt` string, date-time, required: Timestamp when the domain was added

---

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