---
title: "Retrieve Hosting Domain"
method: GET
path: "/newsletters/{id}/hosting-domain"
tags: ["Newsletters"]
---

# Retrieve Hosting Domain

`GET /newsletters/{id}/hosting-domain`

Retrieve the DNS verification status for a newsletter's custom hosting domain. This synchronously re-verifies the domain's DNS records.

## Path parameters

- `id` string, required

## Response `200`

OK

- HostingDomainRecord
  - `domain` string, required — The custom hosting domain being verified.
  - `record_type` string, required — The DNS record type the domain should use (typically `CNAME`).
  - `data` string[], required — The record values currently observed at the domain, if any.
  - `nameservers` string[] — The domain's nameservers, used to detect its DNS provider.
  - `apex_alias_provider` ApexAliasProvider
    - `id` string, required — Stable identifier for the DNS provider (e.g. `cloudflare`).
    - `name` string, required — Human-readable name of the DNS provider.
    - `apex_alias_support` string, required — How the provider supports pointing an apex/root domain at a CNAME target (e.g. CNAME flattening or ALIAS records).
    - `wording_kind` string, required — Which copy variant to show for this provider's setup instructions.
    - `nameserver_regexes` string[], required — Patterns matched against a domain's nameservers to detect this provider.
    - `support_doc_url` string, nullable, required — Link to the provider's own DNS documentation, when available.
    - `side_notes` string, required — Provider-specific caveats to surface alongside the setup guidance.
    - `buttondown_guide_url` string, nullable — A first-party Buttondown setup guide for this provider, when one exists.
    - `supports_nameserver_delegation` boolean — Whether the provider lets customers delegate a child zone with NS records.
  - `status` 'none' | 'invalid' | 'valid', required — The DNS verification status of a newsletter's custom hosting domain.

## Other responses

- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `409` — Conflict
- `429` — Too Many Requests

---

[API](https://skmtc.net/buttondown/apis/buttondown-api.md) · [All operations](https://skmtc.net/buttondown/apis/buttondown-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/buttondown/buttondown-api/versions/71b271a0f44a/schema)