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

# List domains

`GET /v3/admin/domains`

<div id="admonition-warning">⚠️ <b>Before you can use the Manage Domains endpoints, you need a <a href="/docs/v3/auth/nylas-service-account/">Nylas Service Account</a></b>.</div>

Returns a list of all domains registered to your organization.

## Query parameters

- `limit` integer
- `page_token` string

## Response `200`

OK

- object
  - `request_id` string — ID of the request.
  - `data` DomainObject[]
    - `id` string — Globally unique identifier for the domain.
    - `name` string — A human-readable label for the domain.
    - `branded` boolean — If `true`, this is a Nylas-branded `nylas.email` subdomain managed by Nylas. You can only have one free Nylas branded domain per organization and region. If `false`, this is a custom domain.
    - `domain_address` string — The domain address (for example, `mail.example.com`).
    - `organization_id` string — The ID of the Nylas organization that owns the domain.
    - `region` 'us' | 'eu' — The Nylas data center region where the domain is registered.
    - `verified_ownership` boolean — If `true`, the domain's ownership TXT record has been verified.
    - `verified_dkim` boolean — If `true`, the domain's DKIM TXT record has been verified.
    - `verified_spf` boolean — If `true`, the domain's SPF record has been verified.
    - `verified_mx` boolean — If `true`, the domain's MX record has been verified.
    - `verified_feedback` boolean — If `true`, the domain's feedback MX record for bounce detection has been verified.
    - `verified_dmarc` boolean — Currently not verified by Nylas. However, it is highly recommended to set DMARC to your desired value to prevent emails going to spam.
    - `verified_arc` boolean — Currently not verified by Nylas.
    - `created_at` number — When the domain was created, in seconds using the Unix timestamp format.
    - `updated_at` number — When the domain was last updated, in seconds using the Unix timestamp format.
  - `next_cursor` string — A token to use for paginating through results. If present, pass this value as `page_token` in the next request.

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `429` — Rate Limit

---

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