---
title: "List this team's hostnames"
method: GET
path: "/v1/hostnames"
tags: ["hostnames"]
---

# List this team's hostnames

`GET /v1/hostnames`

## Request

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

Lists the team's hostnames, newest first. Released and terminated hostnames are excluded; suspended ones are shown.

## Query parameters

- `limit` integer
- `skip` integer

## Response `200`

The account's hostnames and list metadata.

- HostnameList
  - `hostnames` HostView[], required
    - `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.
  - `total` integer, required: Non-released hostnames on the team. Used for pagination.
  - `active` integer, required: Live hostnames. This is what the create cap counts.
  - `cap` integer, required: Plan maximum for hostnames held at once. Registration returns 429 at the cap.
  - `limit` integer, required: Page size actually applied after clamping.
  - `skip` integer, required: Offset actually applied.

## Other responses

- `401`: The Authorization header is missing, malformed, or the key is unknown or revoked.
- `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)