Skip to main content
POST
/
domain-monitors
/
{id}
curl -X POST "https://kodostatus.com/api/v1/domain-monitors/dom_abc123" \
  -H "X-API-Key: your_api_key"

{
  "status": "ok",
  "days_until_expiry": 285,
  "expires_on": "2026-12-01T00:00:00Z",
  "registrar": "Cloudflare, Inc.",
  "name_servers": ["ns1.cloudflare.com", "ns2.cloudflare.com"],
  "error": null
}
Manually trigger a domain expiration check outside the regular monitoring interval. The check queries WHOIS data for registration and expiry details.

​
Path Parameters

​
id
string
required
The domain monitor ID

​
Response

​
status
string
Check result: ok, warning, critical, or error
​
days_until_expiry
number
Days until the domain registration expires
​
expires_on
string
Domain expiration date (ISO 8601)
​
registrar
string
Domain registrar name
​
name_servers
array
Current name servers for the domain
​
error
string
Error message if the check failed (null on success)
curl -X POST "https://kodostatus.com/api/v1/domain-monitors/dom_abc123" \
  -H "X-API-Key: your_api_key"

{
  "status": "ok",
  "days_until_expiry": 285,
  "expires_on": "2026-12-01T00:00:00Z",
  "registrar": "Cloudflare, Inc.",
  "name_servers": ["ns1.cloudflare.com", "ns2.cloudflare.com"],
  "error": null
}