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

{
  "id": "dom_abc123",
  "domain": "example.com",
  "alert_days": 60,
  "enabled": true,
  "last_checked_at": "2024-01-15T10:30:00Z",
  "registration": {
    "registrar": "Cloudflare, Inc.",
    "registrar_url": "https://cloudflare.com",
    "created_date": "2020-01-15T00:00:00Z",
    "updated_date": "2024-01-10T00:00:00Z",
    "expiry_date": "2025-01-15T00:00:00Z",
    "days_until_expiry": 365,
    "nameservers": ["ns1.cloudflare.com", "ns2.cloudflare.com"],
    "status": ["clientTransferProhibited"]
  },
  "check_history": [
    {
      "checked_at": "2024-01-15T10:30:00Z",
      "days_until_expiry": 365
    }
  ],
  "service_id": null,
  "created_at": "2024-01-01T00:00:00Z"
}

​
Path Parameters

​
id
string
required
The unique identifier of the domain monitor

​
Response

​
id
string
Unique identifier
​
domain
string
Domain being monitored
​
alert_days
number
Days before expiration to alert
​
enabled
boolean
Whether monitoring is active
​
registration
object
Detailed WHOIS information
​
check_history
array
Recent check results
curl "https://kodostatus.com/api/v1/domain-monitors/dom_abc123" \
  -H "X-API-Key: your_api_key"

{
  "id": "dom_abc123",
  "domain": "example.com",
  "alert_days": 60,
  "enabled": true,
  "last_checked_at": "2024-01-15T10:30:00Z",
  "registration": {
    "registrar": "Cloudflare, Inc.",
    "registrar_url": "https://cloudflare.com",
    "created_date": "2020-01-15T00:00:00Z",
    "updated_date": "2024-01-10T00:00:00Z",
    "expiry_date": "2025-01-15T00:00:00Z",
    "days_until_expiry": 365,
    "nameservers": ["ns1.cloudflare.com", "ns2.cloudflare.com"],
    "status": ["clientTransferProhibited"]
  },
  "check_history": [
    {
      "checked_at": "2024-01-15T10:30:00Z",
      "days_until_expiry": 365
    }
  ],
  "service_id": null,
  "created_at": "2024-01-01T00:00:00Z"
}