---
title: "List every bring-your-own domain for the account."
method: GET
path: "/byo-domains"
tags: ["byo-domains"]
---

# List every bring-your-own domain for the account.

`GET /byo-domains`

## Request

- Base URL: `https://api.coldrig.dev`
- URL: `https://api.coldrig.dev/byo-domains`
- Auth: HTTP bearer

Summary rows only — use GET /byo-domains/{id} for the full intake detail (pre-flight scan, abuse verdict, consent status).

## Response `200`

BYO domain summaries.

- ByoDomainSummary[]
  - `domainId` string, required
  - `domain` string, required
  - `isPrimary` boolean, required
  - `dnsMode` 'we_manage_zone' | 'records_to_apply', required
  - `byoStatus` 'pending_kyc' | 'pending_consent' | 'pending_dns' | 'active' | 'rejected' | 'abandoned', required
  - `breakerTier` 'standard' | 'elevated' | 'primary', required
  - `reputationBranch` string, nullable, required
  - `mailboxCount` integer, required

## Other responses

- `401`: Missing, invalid, or inactive bearer token.

---

[API](https://skmtc.dev/coldrig/apis/agent-cold-email-api.md) · [All operations](https://skmtc.dev/coldrig/apis/agent-cold-email-api/llms.txt) · [OpenAPI document](https://skmtc.dev/coldrig/apis/agent-cold-email-api/revisions/242a462d82c4?raw)