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

# List domains

`GET /v1/domains`

## Request

- Base URL: `https://anjal.app`
- URL: `https://anjal.app/v1/domains`
- Auth: API key in header `X-API-Key`

## Query parameters

- `workspace` string, uuid

## Response `200`

OK

- object
  - `domains` Domain[]
    - `id` string, uuid
    - `domain` string
    - `status` 'pending' | 'verified' | 'failed'
    - `workspaceId` string, uuid
    - `dnsRecords` DnsRecord[]
      - `type` 'TXT' | 'CNAME' | 'MX' | 'A'
      - `name` string
      - `value` string
      - `priority` integer, nullable
      - `status` 'pending' | 'verified', nullable
      - `note` string, nullable: Extra instructions for this record. On a shared domain the SPF record is merged into your existing one, and the note says to replace the existing record (a domain must have only one SPF record).
    - `sharedWith` 'google' | 'microsoft' | 'other' | 'null', nullable: Set when the domain's main mail stays at another provider (Google Workspace, Microsoft 365 or other) and Anjal mailboxes live alongside it. Null for a domain whose MX points at Anjal.
    - `routingSteps` string[]: Present only for shared domains. Steps for the provider's admin console so it passes mail for addresses it doesn't know on to Anjal.
    - `createdAt` string, date-time
    - `updatedAt` string, date-time

---

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