Skip to main content
POST
/
domain-monitors
curl -X POST "https://kodostatus.com/api/v1/domain-monitors" \
  -H "X-API-Key: your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "domain": "example.com",
    "alert_days": 60
  }'

{
  "id": "dom_abc123",
  "domain": "example.com",
  "alert_days": 60,
  "enabled": true,
  "last_checked_at": "2024-01-15T10:30:00Z",
  "registration": {
    "registrar": "Cloudflare, Inc.",
    "created_date": "2020-01-15T00:00:00Z",
    "expiry_date": "2025-01-15T00:00:00Z",
    "days_until_expiry": 365,
    "nameservers": ["ns1.cloudflare.com", "ns2.cloudflare.com"]
  },
  "created_at": "2024-01-15T10:30:00Z"
}

​
Request Body

​
domain
string
required
Domain to monitor (e.g., “example.com”). Do not include subdomains or protocol.
​
alert_days
number
default:"60"
Number of days before expiration to trigger alerts. Recommended: 60 for critical domains, 30 for others.
​
service_id
string
Optional service ID to link this monitor to
​
notification_channels
array
Array of notification channel IDs to alert on domain expiration warnings

​
Response

Returns the created domain monitor object with initial WHOIS lookup results. 
curl -X POST "https://kodostatus.com/api/v1/domain-monitors" \
  -H "X-API-Key: your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "domain": "example.com",
    "alert_days": 60
  }'

{
  "id": "dom_abc123",
  "domain": "example.com",
  "alert_days": 60,
  "enabled": true,
  "last_checked_at": "2024-01-15T10:30:00Z",
  "registration": {
    "registrar": "Cloudflare, Inc.",
    "created_date": "2020-01-15T00:00:00Z",
    "expiry_date": "2025-01-15T00:00:00Z",
    "days_until_expiry": 365,
    "nameservers": ["ns1.cloudflare.com", "ns2.cloudflare.com"]
  },
  "created_at": "2024-01-15T10:30:00Z"
}
Domain WHOIS lookups are performed daily. Some registrars may redact WHOIS information for privacy-protected domains.