---
title: "Custom domain status"
method: GET
path: "/v1/account/domains"
tags: ["Account"]
---

# Custom domain status

`GET /v1/account/domains`

## Request

- Base URL: `https://api.briefgate.dev`
- URL: `https://api.briefgate.dev/v1/account/domains`
- Auth: HTTP bearer

State of both custom domains: the sending domain mail goes out from, and the portal domain clients open. Both are also re-checked automatically in the background — every 10 minutes for up to 7 days after being added — so `status`/`checked_at` can change without the customer calling either verify route. `available_on_plan` reports whether the plan allows them.

## Response `200`

Current domain state

- object
  - `sending` object
    - `domain` string, nullable
    - `verified` boolean
    - `verified_at` string, date-time, nullable
    - `status` string, nullable: Resend's domain status, e.g. pending/verified/failed. null when no sending domain is configured.
    - `added_at` string, date-time, nullable
    - `checked_at` string, date-time, nullable: When the background sweep (or a manual verify call) last checked this domain.
    - `dns_records` object[]: Empty when no sending domain is configured.
      - `type` string: DNS record type, e.g. 'TXT', 'MX', 'CNAME'.
      - `name` string
      - `value` string
      - `ttl` unknown
      - `priority` integer: Set on MX records only.
      - `record` 'SPF' | 'DKIM': Sending domain only — which mechanism this record serves.
      - `status` 'not_started' | 'pending' | 'verified' | 'failed' | 'temporary_failure': Per-record verification state. The portal domain's synthesized record only ever reports 'pending' or 'verified'.
    - `local_part` string: Mailbox part of the from-address on this domain, e.g. 'podklady'. Defaults to 'intake'.
    - `from_address` string, nullable: `${local_part}@${domain}` once a sending domain is set, regardless of verification state; null when no sending domain is configured.
  - `portal` object
    - `domain` string, nullable
    - `verified` boolean
    - `verified_at` string, date-time, nullable
    - `cname_target` string: Host the customer points their CNAME at.
    - `dns_records` object[]: The single CNAME to create. Empty when no portal domain is configured.
      - `type` string: DNS record type, e.g. 'TXT', 'MX', 'CNAME'.
      - `name` string
      - `value` string
      - `ttl` unknown
      - `priority` integer: Set on MX records only.
      - `record` 'SPF' | 'DKIM': Sending domain only — which mechanism this record serves.
      - `status` 'not_started' | 'pending' | 'verified' | 'failed' | 'temporary_failure': Per-record verification state. The portal domain's synthesized record only ever reports 'pending' or 'verified'.
  - `available_on_plan` boolean

## Other responses

- `401`: Missing or invalid API key

---

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