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

# List all domains

`GET /domains`

Returns all verified and unverified domains for your organization,
sorted by creation date (newest first). Each domain includes a
`verified` boolean to distinguish between the two states.

## Response `200`

List of domains

- object
  - `success` true, required
  - `data` union[], required
    - union — A domain can be either verified or unverified. Verified domains have `is_active` and `spam_threshold` fields. Unverified domains have a `verification_token` and `dns_records` for DNS setup.
      - object
        - `id` string, uuid, required
        - `org_id` string, uuid, required
        - `domain` string, required
        - `verified` true, required
        - `is_active` boolean, required
        - `spam_threshold` number, nullable
        - `verification_token` string, nullable
        - `created_at` string, date-time, required
      - object
        - `id` string, uuid, required
        - `org_id` string, uuid, required
        - `domain` string, required
        - `verified` false, required
        - `verification_token` string, required — Add this value as a TXT record to verify ownership
        - `dns_records` object[] — Exact DNS records to publish for a pending domain claim or verification attempt.
          - `type` 'MX' | 'TXT', required — DNS record type.
          - `name` string, required — DNS-provider host/name value relative to the managed root zone.
          - `fqdn` string, required — Fully-qualified DNS record name.
          - `value` string, required — Exact value to publish.
          - `priority` integer — MX priority. Present only for MX records.
          - `ttl` integer — Suggested TTL in seconds when the API can provide one.
          - `required` true, required
          - `purpose` 'inbound_mx' | 'ownership_verification' | 'spf' | 'dkim' | 'dmarc' | 'tls_reporting', required
          - `status` 'pending' | 'found' | 'missing' | 'incorrect', required
          - `message` string — Short explanation of why this record is needed.
        - `created_at` string, date-time, required

## Other responses

- `401` — Invalid or missing API key

---

[API](https://skmtc.net/primitive/apis/primitive-api.md) · [All operations](https://skmtc.net/primitive/apis/primitive-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/primitive/primitive-api/versions/c2299d28022c/schema)