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

# List custom domains

`GET /api/v1/domains`

## Request

- Base URL: `https://postfleet.ai`
- URL: `https://postfleet.ai/api/v1/domains`
- Auth: HTTP bearer

Lists this account's custom domains. Account-plane.

## Response `200`

Domains.

- object
  - `domains` Domain[], required
    - `id` string, required
    - `name` string, required
    - `status` string, required
    - `created_at` string, required

## Other responses

- `401`: Missing or invalid bearer token, or a key whose scope is not permitted for this endpoint.
- `403`: Mailbox-bound key on an account-plane route (`code:key_scope`).

---

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