curl "https://kodostatus.com/api/v1/domain-monitors" \
-H "X-API-Key: your_api_key"
const response = await fetch('https://kodostatus.com/api/v1/domain-monitors', {
headers: { 'X-API-Key': 'your_api_key' }
});
const { domain_monitors } = await response.json();
{
"domain_monitors": [
{
"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"]
},
"service_id": null,
"created_at": "2024-01-01T00:00:00Z"
}
]
}
Domain Monitors
List Domain Monitors
Retrieve all domain expiration monitors for your organization
GET
/
domain-monitors
curl "https://kodostatus.com/api/v1/domain-monitors" \
-H "X-API-Key: your_api_key"
const response = await fetch('https://kodostatus.com/api/v1/domain-monitors', {
headers: { 'X-API-Key': 'your_api_key' }
});
const { domain_monitors } = await response.json();
{
"domain_monitors": [
{
"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"]
},
"service_id": null,
"created_at": "2024-01-01T00:00:00Z"
}
]
}
Request
No request body required.Query Parameters
number
default:"50"
Maximum number of monitors to return (1-100)
number
default:"0"
Number of monitors to skip for pagination
Response
array
Array of domain monitor objects
Show Domain Monitor Object
Show Domain Monitor Object
string
Unique identifier
string
Domain being monitored
number
Days before expiration to alert
boolean
Whether monitoring is active
string
ISO 8601 timestamp of last check
object
string
Linked service ID
string
ISO 8601 timestamp
curl "https://kodostatus.com/api/v1/domain-monitors" \
-H "X-API-Key: your_api_key"
const response = await fetch('https://kodostatus.com/api/v1/domain-monitors', {
headers: { 'X-API-Key': 'your_api_key' }
});
const { domain_monitors } = await response.json();
{
"domain_monitors": [
{
"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"]
},
"service_id": null,
"created_at": "2024-01-01T00:00:00Z"
}
]
}
⌘I