Trigger Domain Check

curl -X POST "https://kodostatus.com/api/v1/domain-monitors/dom_abc123" \
  -H "X-API-Key: your_api_key"

const response = await fetch('https://kodostatus.com/api/v1/domain-monitors/dom_abc123', {
  method: 'POST',
  headers: { 'X-API-Key': 'your_api_key' }
});
const result = await response.json();
console.log(`Domain expires in ${result.days_until_expiry} days (${result.registrar})`);

{
  "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
}

POST

domain-monitors

{id}

curl -X POST "https://kodostatus.com/api/v1/domain-monitors/dom_abc123" \
  -H "X-API-Key: your_api_key"

const response = await fetch('https://kodostatus.com/api/v1/domain-monitors/dom_abc123', {
  method: 'POST',
  headers: { 'X-API-Key': 'your_api_key' }
});
const result = await response.json();
console.log(`Domain expires in ${result.days_until_expiry} days (${result.registrar})`);

{
  "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

string

required

The domain monitor ID

Response

string

Check result: ok, warning, critical, or error

number

Days until the domain registration expires

string

Domain expiration date (ISO 8601)

string

Domain registrar name

array

Current name servers for the domain

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"

const response = await fetch('https://kodostatus.com/api/v1/domain-monitors/dom_abc123', {
  method: 'POST',
  headers: { 'X-API-Key': 'your_api_key' }
});
const result = await response.json();
console.log(`Domain expires in ${result.days_until_expiry} days (${result.registrar})`);

{
  "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
}

Delete Domain Monitor Send Heartbeat

Overview

Status Pages

Status Page Design

Incidents

Services

Uptime Monitors

SSL Monitors

Domain Monitors

Heartbeat

Metrics

Notification Channels

Webhooks

Error Tracking

Releases

Source Maps

Maintenance

Configuration

Workflows

API Keys

Audit Log

Beacon

Trigger Domain Check

Path Parameters

Response

​Path Parameters

​Response

Path Parameters

Response