# List domains

`GET https://api.cademi.com.br/api/v3/account/domains`

Operation ID: `account.domains.list` · API v3

Lists the custom domains configured for the account.

An account has at most one custom domain, so the collection contains zero or one item. Domain status reflects the last state recorded by Cademí and is not checked live.

Requires the `domains.read` permission.

Required permissions: `domains.read`.

## Responses

### 200

Returns the collection of custom domains, containing zero or one item.

Body: `data`: array of Domain.

Fields of Domain:

| Field | Type | Required | Description |
|---|---|---|---|
| `dns` | object | yes |  |
| `hostname` | string | yes |  |
| `id` | string | yes |  |
| `object` | string, one of `domain` | yes | String representing the object's type. |
| `processing` | boolean | yes |  |
| `status` | string, one of `not_configured`, `queued`, `invalid`, `invalid_pointing`, `verified`, `issuing`, `active` | yes |  |
| `updated_at` | string or null (date-time) | yes |  |
| `verifiable` | boolean | yes |  |

### 401

The credential is missing, malformed, expired, or revoked.

Body: Error.

### 403

The current credentials do not have the permission required by this operation.

Body: Error.

Full schema: https://cademi.dev/openapi/v3.json