hosting
POST /v1/sites/{siteId}/domain-pointing/check
Check the site's own domain now (DNS, nameservers, SSL).
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
| Name | Type | Required | What it is |
|---|---|---|---|
siteId (path) | Uuid | Yes | Site ID (UUIDv7). |
Response
| Name | Type | Required | What it is |
|---|---|---|---|
hostname | string | Yes | — |
state | string<moving_in, serving, serving_via_other_dns, propagating, awaiting_record, awaiting_pointing, pointed_elsewhere, zone_expired, unknown> | Yes | serving 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… |
reason | string | Yes | A stable machine code for the leg that decided the state. |
next_action | string<set_nameservers_at_registrar, add_record_at_your_dns_provider, recreate_dns_zone, > | Yes | The 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_at | string | Yes | When 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. |
observed | object | Yes | — |
set | object | Yes | What the customer must set. Empty lists mean "not applicable". |
move | object | No | Present 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. |
progress | SiteOwnDomainProgress | No | Where 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;… |
diagnosis | SiteOwnDomainDiagnosis | No | What 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_state | object | No | The 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_mix | object | No | Hostnames 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