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

{
  "status": "ok",
  "days_until_expiry": 76,
  "valid_to": "2026-05-01T00:00:00Z",
  "issuer": "Let's Encrypt Authority X3",
  "subject": "api.example.com",
  "error": null,
  "response_time_ms": 245
}
Manually trigger an SSL certificate check outside the regular monitoring interval. The check verifies certificate validity, expiration, and chain of trust.

​
Path Parameters

​
id
string
required
The SSL monitor ID

​
Response

​
status
string
Check result: ok, warning, critical, or error
​
days_until_expiry
number
Days until the certificate expires
​
valid_to
string
Certificate expiration date (ISO 8601)
​
issuer
string
Certificate Authority name
​
subject
string
Certificate subject (domain)
​
error
string
Error message if the check failed (null on success)
​
response_time_ms
number
Time taken to complete the check in milliseconds
curl -X POST "https://kodostatus.com/api/v1/ssl-monitors/ssl_abc123" \
  -H "X-API-Key: your_api_key"

{
  "status": "ok",
  "days_until_expiry": 76,
  "valid_to": "2026-05-01T00:00:00Z",
  "issuer": "Let's Encrypt Authority X3",
  "subject": "api.example.com",
  "error": null,
  "response_time_ms": 245
}