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

# List Domains

`GET /domains`

## Request

- Base URL: `https://app.lettr.com/api`
- URL: `https://app.lettr.com/api/domains`
- Auth: HTTP bearer

Retrieve all sending domains registered with your account. Returns domains with their current status, verification state, and timestamps.

## Response `200`

List of domains retrieved successfully

- ListDomainsResponse: Response containing a list of domains
  - `message` string, required: Human-readable response message
  - `data` object, required
    - `domains` DomainListItemView[], required: List of domains
      - `domain` string, required: The domain name
      - `status` 'pending' | 'approved' | 'blocked', required: Current status of the domain
      - `status_label` string, required: Human-readable status label
      - `can_send` boolean, required: Whether the domain can be used for sending emails
      - `cname_status` string, nullable: CNAME verification status
      - `dkim_status` string, nullable: DKIM verification status
      - `created_at` string, date-time, nullable, required: When the domain was created. Null for legacy records stored without a creation timestamp.
      - `updated_at` string, date-time, nullable, required: When the domain was last updated. Falls back to the creation timestamp, and is null when neither is stored.

## Other responses

- `401`: Unauthorized - Missing or invalid API key
- `500`: Server error - Failed to retrieve domains
- `503`: Service unavailable - the API key could not be verified, so the request was not processed. This does not mean the key is invalid; retry after the delay given in the Retry-After header.

---

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