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

# List domains

`GET /domains`

List custom domains for the account.

## Response `200`

Domains list

- Domain[] — List of custom domain objects
  - `_id` string, domain — domain
  - `created` string, date-time — Date domain was created
  - `updated` string, date-time — Date domain settings were last updated
  - `enablews` boolean — boolean defaulting false indicating whether to publish messages via web socket to any subscribed web socket sessions
  - `hosted` boolean — boolean defaulting false indicating whether this is managed by mailsac (on msdc.co)
  - `isDefault` boolean — boolean defaulting false indicating whether this is the default domain for the account which will show in the sidebar first
  - `isPrivate` boolean — boolean defaulting true indicating whether inboxes and messages for this domain will be visible publicly
  - `lastVerificationErrors` string — during custom domain verification, this field indicates dns issues
  - `owner` string — the account to which this domain is assigned and can be managed
  - `verificationTxt` string — during custom domain verification, this field indicates value of a TXT record that must be added to the domain's DNS settings
  - `verified` boolean — boolean defaulting false indicating whether this domain has been verified via dns TXT record verificationTxt
  - `verifiedMx` boolean — boolean defaulting false indicating whether the domain will receive email successfully at Mailsac. Tthis domain has been verified via dns MX records when true.

## Other responses

- `401` — Not authorized. You may need to log in first.

---

[API](https://skmtc.dev/mailsac/apis/mailsac-api-specification.md) · [All operations](https://skmtc.dev/mailsac/apis/mailsac-api-specification/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/mailsac/mailsac-api-specification/revisions/5f8b55c76229/schema)