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

# List domains

`GET /domains`

## Request

- Base URL: `https://api.mailforge.ai/public`
- URL: `https://api.mailforge.ai/public/domains`
- Auth: API key in header `Authorization`

Returns all domains belonging to the account. Optionally filtered by status or search query.

## Query parameters

- `status` 'active' | 'pending' | 'failed' | 'expired' | 'scheduled_for_deletion' | 'not_paid'
- `search` string

## Response `200`

OK

- MailforgeExternalApiDeliveryApiDomainResponse[]
  - `autoRenewFailedReason` string
  - `autoRenewLastProcessedExpiration` string
  - `autoRenewProcessedAt` string
  - `autoRenewStatus` 'disabled' | 'enabled' | 'failed'
  - `createdAt` string
  - `dmarcEmail` string
  - `expiresAt` string
  - `failedReason` string
  - `forwardToDomain` string
  - `id` string
  - `isTransferred` boolean
  - `mailDeletionAt` string
  - `mailServerId` integer
  - `nameservers` string[]
  - `priceCents` integer
  - `setupId` string
  - `sld` string
  - `status` 'draft' | 'active' | 'pending' | 'failed' | 'expired' | 'warning' | 'scheduled_for_deletion' | 'not_paid'
  - `tld` string
  - `type` 'v2'
  - `updatedAt` string
  - `workspaceId` string

## Other responses

- `400`: Invalid domain status

---

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