domains
GET /v1/domain-watches
The domains this customer is watching — ours, theirs and third parties'.
Autenticación
Envía una clave de API como token de portador. Este endpoint no especifica un permiso concreto en la especificación, así que otorga a tu clave los mínimos privilegios necesarios y comprueba la respuesta en lugar de dar por sentado.
Donde va el ID de tu organización
Este endpoint acepta org_id como parámetro de consulta. Omítelo y la llamada abarcará todo tu subárbol de inquilinos; envíalo para acotar la llamada a una sola organización.
El id de tu organización se encuentra en la pantalla de claves de API en tu panel de control, junto a la propia clave. Es el mismo id en cada llamada que realices.
Pruébalo
Reemplaza cualquier elemento entre corchetes angulares por tus propios valores, y el marcador de posición key con una clave de tu panel de control.
curl -X GET https://api.zinndigital.com/v1/domain-watches \
-H "Authorization: Bearer zdk_live_…"¿Has iniciado sesión? La consola de la API en tu panel de control rellena el ID de tu organización real y tu propia clave, y ejecuta la solicitud contra la API en vivo para que puedas ver la respuesta real. Abre este endpoint en la consola de la API
Detalles
The domain monitor (⚖️ owner 2026-08-30, `docs/296` §5). Every domain registered with us and every domain attached to hosting with us is on this list automatically; the customer may add any other name they like, mute one, or remove it. ⛔ **A removed watch is soft-removed and never returned here.** Auto-add runs on every provision, so a hard delete would let tomorrow's provision resurrect a domain the customer deliberately took off their list — for ever, with no way for them to make it stop. `last_checked_at` is when the registry last answered, and it is rendered beside every value on the row for a reason: these facts are a snapshot of the outside world and go stale silently (§2.36). A tick with no date on it is indistinguishable from a live one. `expires_at` and `days_until_expiry` are `null` when the registry did not say — which is a different fact from "it expires in a decade" and must not render as one.
Parámetros
| Nombre | Tipo | Obligatorio | ¿Qué es esto? |
|---|---|---|---|
org_id (query) | string | No | Narrow to one organisation in the caller's subtree — what the dashboard's org switcher sends. ⛔ **Narrow only:** intersected with what the caller may already read, so it can nev… |
source (query) | string<registered, hosting, manual> | No | Only watches that arrived this way. |
limit (query) | integer | No | — |
offset (query) | integer | No | — |
Respuesta
| Nombre | Tipo | Obligatorio | ¿Qué es esto? |
|---|---|---|---|
items | DomainWatch[] | Sí | — |
total | integer | Sí | The full match, so the screen can page all of it. |
Errores que este endpoint puede devolver
401 · 403