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

{
  "id": "ssl_abc123",
  "domain": "api.example.com",
  "port": 443,
  "alert_days": 30,
  "enabled": true,
  "last_checked_at": "2024-01-15T10:30:00Z",
  "certificate": {
    "issuer": "Let's Encrypt Authority X3",
    "subject": "api.example.com",
    "valid_from": "2024-01-01T00:00:00Z",
    "valid_to": "2024-04-01T00:00:00Z",
    "days_until_expiry": 76,
    "is_valid": true,
    "serial_number": "03:a1:b2:c3:d4:e5:f6",
    "fingerprint": "SHA256:abc123...",
    "san": ["api.example.com", "*.example.com"]
  },
  "check_history": [
    {
      "checked_at": "2024-01-15T10:30:00Z",
      "days_until_expiry": 76,
      "is_valid": true
    }
  ],
  "service_id": "svc_xyz789",
  "created_at": "2024-01-01T00:00:00Z"
}

​
Path Parameters

​
id
string
required
The unique identifier of the SSL monitor

​
Response

​
id
string
Unique identifier for the SSL monitor
​
domain
string
Domain being monitored
​
port
number
Port being checked
​
alert_days
number
Days before expiration to trigger alerts
​
enabled
boolean
Whether monitoring is active
​
certificate
object
Detailed certificate information
​
check_history
array
Recent check results (last 30 days)
curl "https://kodostatus.com/api/v1/ssl-monitors/ssl_abc123" \
  -H "X-API-Key: your_api_key"

{
  "id": "ssl_abc123",
  "domain": "api.example.com",
  "port": 443,
  "alert_days": 30,
  "enabled": true,
  "last_checked_at": "2024-01-15T10:30:00Z",
  "certificate": {
    "issuer": "Let's Encrypt Authority X3",
    "subject": "api.example.com",
    "valid_from": "2024-01-01T00:00:00Z",
    "valid_to": "2024-04-01T00:00:00Z",
    "days_until_expiry": 76,
    "is_valid": true,
    "serial_number": "03:a1:b2:c3:d4:e5:f6",
    "fingerprint": "SHA256:abc123...",
    "san": ["api.example.com", "*.example.com"]
  },
  "check_history": [
    {
      "checked_at": "2024-01-15T10:30:00Z",
      "days_until_expiry": 76,
      "is_valid": true
    }
  ],
  "service_id": "svc_xyz789",
  "created_at": "2024-01-01T00:00:00Z"
}