> ## 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 Domain Monitors

> Retrieve all domain expiration 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="domain_monitors" type="array">
  Array of domain monitor objects

  <Expandable title="Domain Monitor Object">
    <ResponseField name="id" type="string">Unique identifier</ResponseField>
    <ResponseField name="domain" type="string">Domain being monitored</ResponseField>
    <ResponseField name="alert_days" type="number">Days before expiration to alert</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="registration" type="object">
      Domain registration details

      <Expandable title="Registration Object">
        <ResponseField name="registrar" type="string">Domain registrar name</ResponseField>
        <ResponseField name="created_date" type="string">Domain registration date</ResponseField>
        <ResponseField name="expiry_date" type="string">Domain expiration date</ResponseField>
        <ResponseField name="days_until_expiry" type="number">Days until expiration</ResponseField>
        <ResponseField name="nameservers" type="array">List of nameservers</ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="service_id" type="string">Linked service ID</ResponseField>
    <ResponseField name="created_at" type="string">ISO 8601 timestamp</ResponseField>
  </Expandable>
</ResponseField>

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

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

<ResponseExample>
  ```json theme={null}
  {
    "domain_monitors": [
      {
        "id": "dom_abc123",
        "domain": "example.com",
        "alert_days": 60,
        "enabled": true,
        "last_checked_at": "2024-01-15T10:30:00Z",
        "registration": {
          "registrar": "Cloudflare, Inc.",
          "created_date": "2020-01-15T00:00:00Z",
          "expiry_date": "2025-01-15T00:00:00Z",
          "days_until_expiry": 365,
          "nameservers": ["ns1.cloudflare.com", "ns2.cloudflare.com"]
        },
        "service_id": null,
        "created_at": "2024-01-01T00:00:00Z"
      }
    ]
  }
  ```
</ResponseExample>