domains

GET /v1/domains/{domainId}

Get a domain.

Alle domains-eindpunten

Authenticatie

Stuur een API-sleutel mee als bearer token. Dit eindpunt vermeldt geen specifieke toestemming in de specificatie, dus geef uw sleutel de minimale rechten die nodig zijn en controleer het antwoord in plaats van zomaar wat aan te nemen.

Dit eindpunt vereist geen organisatie-id. Uw sleutel identificeert al de organisatie waartoe deze behoort, en het antwoord is hierop afgestemd.

Probeer het

Vervang alles tussen punthaakjes door uw eigen waarden en de sleutelplaatsvervanger door een sleutel uit uw dashboard.

curl -X GET https://api.zinndigital.com/v1/domains/{domainId} \
  -H "Authorization: Bearer zdk_live_…"

Ingelogd? De API-console in je dashboard vult je echte organisatie-id en je eigen sleutel in, en voert het verzoek uit tegen de live API zodat je de daadwerkelijke respons kunt zien. Open dit eindpunt in de API-console

Details

Returns one domain the caller can view. RBAC + RLS scoped.

Parameters

NaamTypeVerplichtWat dit is
domainId (path)UuidJaThe domain's id.

Reactie

NaamTypeVerplichtWat dit is
idUuidJaUUIDv7 identifier — sortable by creation time (docs/02 §8).
org_idUuidJaUUIDv7 identifier — sortable by creation time (docs/02 §8).
fqdnHostnameJaA fully-qualified DNS hostname, lowercase, no trailing dot.
sldstringJa
tldstringJa
product_linestringNeeThe product line this domain was created on. **Not decoration** — it is what decides whether the shared fleet A/AAAA records are hidden from the customer (register #93), so the…
ownership_modestring<registered, connected, transferring_in>Ja
statusDomainStatusJaA domain's lifecycle state (docs/31 §4.10).
registered_atobjectNee
expires_atobjectNee
auto_renewbooleanJa
renew_yearsintegerJa
registrar_lockbooleanNee
privacy_enabledbooleanNee
nameserversstring[]Ja
dnssec_enabledbooleanNee
site_idUuid | nullNeeThe site this domain points at, if any.
created_atstringJa
updated_atstringNee

Fouten die dit eindpunt kan retourneren

401 · 403 · 404 · 429