> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kodostatus.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Trigger SSL Check

> Trigger an immediate SSL certificate check and return the results

Manually trigger an SSL certificate check outside the regular monitoring interval. The check verifies certificate validity, expiration, and chain of trust.

## Path Parameters

<ParamField path="id" type="string" required>
  The SSL monitor ID
</ParamField>

## Response

<ResponseField name="status" type="string">
  Check result: `ok`, `warning`, `critical`, or `error`
</ResponseField>

<ResponseField name="days_until_expiry" type="number">
  Days until the certificate expires
</ResponseField>

<ResponseField name="valid_to" type="string">
  Certificate expiration date (ISO 8601)
</ResponseField>

<ResponseField name="issuer" type="string">
  Certificate Authority name
</ResponseField>

<ResponseField name="subject" type="string">
  Certificate subject (domain)
</ResponseField>

<ResponseField name="error" type="string">
  Error message if the check failed (null on success)
</ResponseField>

<ResponseField name="response_time_ms" type="number">
  Time taken to complete the check in milliseconds
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl -X POST "https://kodostatus.com/api/v1/ssl-monitors/ssl_abc123" \
    -H "X-API-Key: your_api_key"
  ```

  ```javascript Node.js theme={null}
  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`);
  ```
</RequestExample>

<ResponseExample>
  ```json theme={null}
  {
    "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
  }
  ```
</ResponseExample>