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

# List domains

`GET /domains`

## Request

- Base URL: `https://faivelo.com/api/v1`
- URL: `https://faivelo.com/api/v1/domains`
- Auth: HTTP bearer

Returns all domains on your account. Requires scope `domains:read`.

## Response `200`

Domain list

- object
  - `success` boolean
  - `data` DomainSummary[]
    - `domain` string
    - `verified` boolean
    - `mailboxCount` integer
    - `createdAt` string, date-time

## Other responses

- `401`: Missing or invalid API key
- `402`: The account's plan does not include the API (`plan_required`)
- `403`: The key lacks the required scope
- `429`: Rate limit exceeded

---

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