domains

GET /v1/domains/{domainId}/contacts

The registrant contact on public WHOIS for this domain.

All domains endpoints

Authentication

Send an API key as a bearer token. This endpoint does not state a specific permission in the specification, so give your key the least it needs and check the response rather than assuming.

This endpoint takes no organisation id. Your key already identifies the organisation it belongs to, and the response is scoped to it.

Try it

Replace anything in angle brackets with your own values, and the key placeholder with a key from your dashboard.

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

Signed in? The API console in your dashboard fills in your real organisation id and your own key, and runs the request against the live API so you can see the actual response. Open this endpoint in the API console

Details

Who the registry believes owns this domain. `contact` is `null` where we hold none — deliberately, because "we have no contact" and "the contact is blank" are different facts and an empty object asserts the second. `editable` says whether this domain's registrar publishes a way to change it. It is `false` on the Cloudflare route, which accepts contacts only when the domain is first registered, so the console renders the panel read-only rather than offering a control that would answer 422.

Parameters

NameTypeRequiredWhat it is
domainId (path)UuidYesThe domain's id.

Response

NameTypeRequiredWhat it is
contactDomainContact | nullYes
editablebooleanYesWhether this domain's registrar publishes a contact-update path. `false` on the Cloudflare route; the console renders the panel read-only rather than offering a control that ans…

Errors this endpoint can return

401 · 403 · 404 · 429