---
title: "Read one hostname"
method: GET
path: "/v1/hostnames/{id}"
tags: ["hostnames"]
---

# Read one hostname

`GET /v1/hostnames/{id}`

## Request

- Base URL: `https://dnsmint.com/api`
- URL: `https://dnsmint.com/api/v1/hostnames/{id}`
- Auth: HTTP bearer

Returns one hostname. New registrations may briefly return "pending"; poll GET until "live".

## Response `200`

The hostname.

- HostView: A hostname. Where it points is deliberately not here: `ip`, `record_type` and the target are either something you just sent or something DNS answers authoritatively, and a second copy in this body can only disagree with it. Ask /v1/hostnames/{id}/diagnose for where it points and what we observed, with the time we observed it.
  - `id` string, required: Opaque identifier used in the /v1/hostnames/{id} paths.
  - `hostname` string, required: The fully qualified hostname: an opaque subdomain on a domain assigned to your account.
  - `status` 'pending' | 'live' | 'released' | 'suspended' | 'terminated', required: pending: registered, not yet confirmed on the nameservers. live: the record is served, and it stays so until you release it. released: you released it; writes return 409 and the subdomain can be minted again as a new hostname. suspended: held while an abuse report is reviewed; it stops resolving and writes return 403, but nothing is lost if the report is not upheld. terminated: an abuse report was upheld, not reversible. New registrations may briefly return pending; poll GET until live.
  - `certificate` 'self' | 'csr' | 'managed', required: Who holds the private key. self: you, and you run the ACME client. csr: you hold the key and we run the protocol around your signed request. managed: we generate the key, obtain and renew the certificate, and keep a copy for you to fetch.
  - `created_at` string, date-time, required: When the hostname was registered.

## Other responses

- `401`: The Authorization header is missing, malformed, or the key is unknown or revoked.
- `404`: No hostname with this id belongs to the authenticated account.
- `500`: Unexpected server error.

---

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