hosting

POST /v1/sites/{siteId}/domain-pointing/check

Check the site's own domain now (DNS, nameservers, SSL).

All hosting endpoints

All developer docs →

Zinn®, our Viking, hammering at his anvil beside an API endpoint sending events to several listeners.

Authentication

Send an API key as a bearer token. The key must carry the sites.view permission; a key without it is refused with 403, not 404.

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 POST https://api.zinndigital.com/v1/sites/{siteId}/domain-pointing/check \
  -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

The live DNS/nameserver check behind the site page's "Check now", the MCP tool site_domain_check, the dashboard assistant and the support-ticket AI — one implementation. Reads the public DNS now (at most one live reading per 30 seconds per domain; inside that window it answers from the last reading), restarts the fast check ladder, marks the site live on its own domain the moment DNS reaches us, and looks up the registrar and the nameservers the registry holds. Changes nothing the customer owns. Requires sites.view.

Parameters

NameTypeRequiredWhat it is
siteId (path)UuidYesSite ID (UUIDv7).

Response

NameTypeRequiredWhat it is
hostnamestringYes—
statestring<moving_in, serving, serving_via_other_dns, propagating, awaiting_record, awaiting_pointing, pointed_elsewhere, zone_expired, unknown>Yesserving reaches us on our nameservers. serving_via_other_dns is PROVEN to reach us through DNS the customer runs — never show it a nameserver instruction, that would take a…
reasonstringYesA stable machine code for the leg that decided the state.
next_actionstring<set_nameservers_at_registrar, add_record_at_your_dns_provider, recreate_dns_zone, >YesThe step the customer takes, or empty when there is none. A stable code, never a sentence — the words are localized on the surface. Q464: set_nameservers_at_registrar is sent…
measured_atstringYesWhen the VERDICT was reached. Null means never measured. Deliberately not the delegation row's checked_at, which moves on every reading including one that established nothing.
observedobjectYes—
setobjectYesWhat the customer must set. Empty lists mean "not applicable".
moveobjectNoPresent when a partner moved (or is moving) the site in: who holds the zone, the records pointing at us, proxied or not, the SSL mode and the certificate state.
progressSiteOwnDomainProgressNoWhere the site is on the "Attach your own domain" ladder (SITEDOMAIN 1108#21): waiting (DNS does not reach us yet) -> found (it does; confirming) -> ssl (reached;…
diagnosisSiteOwnDomainDiagnosisNoWhat is set, what is expected, what is wrong and the exact fix, for a person or an AI. fix is plain English for the assistant and the support-ticket AI to relay; screens render…
site_stateobjectNoThe customer's OWN state that keeps visitors out, measured by the serving sweep (s1014 DNSSTATE): maintenance_mode (a maintenance page the site itself serves) or…
holder_mixobjectNoHostnames that publish the parking holder's addresses AND the site's own target, so some visitors get the holder page (s1014 DNSSTATE). Null when none.…

Errors this endpoint can return

401 · 403 · 404 · 429