# Retrieve a domain

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

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

Retrieves the account's custom domain by its public ID.

An account has at most one custom domain, and its ID is fixed for the account. Use the ID returned by the list operation. Any other ID returns `404 Not Found`.

Required permissions: `domains.read`.

## Parameters

| Name | In | Type | Required | Description |
|---|---|---|---|---|
| `domain_id` | path | string | yes |  |

## Responses

### 200

Returns the requested custom domain.

Body: `data`: 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.

### 404

The domain was not found or is not accessible with the current credentials. Also returned when the account has no custom domain.

Body: Error.

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