> ## 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.

# List SSL Monitors

> Retrieve all SSL certificate monitors for your organization

## Request

No request body required.

### Query Parameters

<ParamField query="limit" type="number" default="50">
  Maximum number of monitors to return (1-100)
</ParamField>

<ParamField query="offset" type="number" default="0">
  Number of monitors to skip for pagination
</ParamField>

## Response

<ResponseField name="ssl_monitors" type="array">
  Array of SSL monitor objects

  <Expandable title="SSL Monitor Object">
    <ResponseField name="id" type="string">
      Unique identifier for the SSL monitor
    </ResponseField>

    <ResponseField name="domain" type="string">
      Domain being monitored (e.g., "api.example.com")
    </ResponseField>

    <ResponseField name="port" type="number">
      Port to check (default: 443)
    </ResponseField>

    <ResponseField name="alert_days" type="number">
      Days before expiration to trigger alerts
    </ResponseField>

    <ResponseField name="enabled" type="boolean">
      Whether monitoring is active
    </ResponseField>

    <ResponseField name="last_checked_at" type="string">
      ISO 8601 timestamp of last check
    </ResponseField>

    <ResponseField name="certificate" type="object">
      Current certificate details

      <Expandable title="Certificate Object">
        <ResponseField name="issuer" type="string">Certificate issuer</ResponseField>
        <ResponseField name="subject" type="string">Certificate subject</ResponseField>
        <ResponseField name="valid_from" type="string">Certificate start date</ResponseField>
        <ResponseField name="valid_to" type="string">Certificate expiration date</ResponseField>
        <ResponseField name="days_until_expiry" type="number">Days remaining</ResponseField>
        <ResponseField name="is_valid" type="boolean">Whether certificate is currently valid</ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="service_id" type="string">
      Linked service ID (if any)
    </ResponseField>

    <ResponseField name="created_at" type="string">
      ISO 8601 timestamp
    </ResponseField>
  </Expandable>
</ResponseField>

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

  ```javascript Node.js theme={null}
  const response = await fetch('https://kodostatus.com/api/v1/ssl-monitors', {
    headers: { 'X-API-Key': 'your_api_key' }
  });
  const { ssl_monitors } = await response.json();
  ```
</RequestExample>

<ResponseExample>
  ```json theme={null}
  {
    "ssl_monitors": [
      {
        "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
        },
        "service_id": "svc_xyz789",
        "created_at": "2024-01-01T00:00:00Z"
      }
    ]
  }
  ```
</ResponseExample>