curl -X POST "https://kodostatus.com/api/v1/ssl-monitors/ssl_abc123" \
-H "X-API-Key: your_api_key"
const response = await fetch('https://kodostatus.com/api/v1/ssl-monitors/ssl_abc123', {
method: 'POST',
headers: { 'X-API-Key': 'your_api_key' }
});
const result = await response.json();
console.log(`Certificate expires in ${result.days_until_expiry} days`);
{
"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
}
SSL Monitors
Trigger SSL Check
Trigger an immediate SSL certificate check and return the results
POST
/
ssl-monitors
/
{id}
curl -X POST "https://kodostatus.com/api/v1/ssl-monitors/ssl_abc123" \
-H "X-API-Key: your_api_key"
const response = await fetch('https://kodostatus.com/api/v1/ssl-monitors/ssl_abc123', {
method: 'POST',
headers: { 'X-API-Key': 'your_api_key' }
});
const result = await response.json();
console.log(`Certificate expires in ${result.days_until_expiry} days`);
{
"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
string
required
The SSL monitor ID
Response
string
Check result:
ok, warning, critical, or errornumber
Days until the certificate expires
string
Certificate expiration date (ISO 8601)
string
Certificate Authority name
string
Certificate subject (domain)
string
Error message if the check failed (null on success)
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"
const response = await fetch('https://kodostatus.com/api/v1/ssl-monitors/ssl_abc123', {
method: 'POST',
headers: { 'X-API-Key': 'your_api_key' }
});
const result = await response.json();
console.log(`Certificate expires in ${result.days_until_expiry} days`);
{
"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
}