---
title: "List monitors"
method: GET
path: "/monitors"
tags: ["Monitors"]
---

# List monitors

`GET /monitors`

List all monitors in a user's account. Values can be paginated with the cursor parameter. Optionally filter by tags, URL, name, status, groupId, or limit. All filters use AND logic when combined.

## Query parameters

- `customField` string[]
- `limit` number
- `groupId` number
- `status` string
- `name` string
- `url` string
- `tags` string
- `cursor` number

## Response `200`

- MonitorPaginationDto
  - `nextLink` string, nullable, required
  - `data` object[], required
    - `type` unknown, required
    - `interval` number, required
    - `sslBrand` string, nullable, required
    - `sslExpiryDateTime` union, required
      - unknown
      - string
    - `domainExpireDate` union, required
      - unknown
      - string
    - `checkSSLErrors` boolean, required
    - `sslExpirationReminder` boolean, nullable, required
    - `domainExpirationReminder` boolean, nullable, required
    - `followRedirections` boolean, required
    - `authType` unknown, required
    - `httpUsername` string
    - `httpPassword` string
    - `customHttpHeaders` object, nullable, required
    - `httpMethodType` unknown, required
    - `successHttpResponseCodes` string[], required
    - `timeout` number, nullable, required
    - `postValueData` union, required
      - string
      - number
      - object
      - unknown[]
        - unknown
    - `postValueType` 'KEY_VALUE' | 'RAW_JSON', nullable, required
    - `port` number, nullable, required
    - `gracePeriod` number, nullable, required
    - `keywordValue` string, nullable, required
    - `keywordCaseType` union, required
      - number
      - number
    - `keywordType` unknown, required
    - `responseTimeThreshold` number, required
    - `config` object, nullable, required
      - `dnsRecords` object
        - `CNAME` string[]
        - `MX` string[]
        - `NS` string[]
        - `A` string[]
        - `AAAA` string[]
        - `TXT` string[]
        - `SRV` string[]
        - `PTR` string[]
        - `SOA` string[]
        - `SPF` string[]
        - `DNSKEY` string[]
        - `DS` string[]
        - `NSEC` string[]
        - `NSEC3` string[]
      - `apiAssertions` object
        - `logic` 'AND' | 'OR', required
        - `checks` object[], required
          - `property` string, required
          - `comparison` 'equals' | 'not_equals' | 'contains' | 'not_contains' | 'greater_than' | 'less_than' | 'is_null' | 'is_not_null', required
          - `target` union
            - string
            - number
            - boolean
            - unknown
      - `sslExpirationPeriodDays` integer[]
      - `udp` object
        - `payload` string
        - `packetLossThreshold` number, required
      - `ipVersion` 'ipv4Only' | 'ipv6Only'
      - `applicationErrorRetries` integer
      - `visualComparison` object
        - `sensitivityThreshold` integer, required
        - `viewport` 'desktop' | 'mobile', required
        - `areaCoordinates` object
          - `percentX` number, required
          - `percentY` number, required
          - `percentWidth` number, required
          - `percentHeight` number, required
        - `refreshBaseline` boolean
        - `userBaselinePath` string
        - `lastCheckBaselinePath` string
    - `regionalData` object, required
      - `REGION` string[], required
      - `MANUAL_SELECTED` boolean
      - `INFRASTRUCTURE` 'Legacy' | 'New'
      - `THRESHOLD` object
    - `maintenanceWindows` object[], required
      - `id` number, required
      - `userId` number, required
      - `name` string, required
      - `interval` 'once' | 'daily' | 'weekly' | 'monthly', required
      - `date` string, nullable, required
      - `time` string, required
      - `duration` number, required
      - `autoAddMonitors` boolean, required
      - `monitorIds` number[], required
      - `days` number[], required
      - `status` 'active' | 'paused', required
      - `created` union, required
        - unknown
        - string
    - `psps` object[], required
      - `id` integer, required
      - `friendlyName` string, required
      - `customDomain` string, nullable, required
      - `isPasswordSet` boolean, required
      - `monitorIds` number[], nullable, required
      - `tagIds` number[], required
      - `monitorsCount` number, nullable, required
      - `status` unknown, required
      - `urlKey` string, required
      - `homepageLink` string, nullable, required
      - `gaCode` string, nullable, required
      - `shareAnalyticsConsent` boolean, required
      - `useSmallCookieConsentModal` boolean, required
      - `icon` string, nullable, required
      - `noIndex` boolean, required
      - `logo` string, nullable, required
      - `hideUrlLinks` boolean, required
      - `subscription` boolean, required
      - `showCookieBar` boolean, required
      - `pinnedAnnouncementId` integer, nullable, required
      - `customSettings` object, nullable, required
        - `font` object, nullable
          - `family` string, nullable, required
        - `page` object
          - `layout` string
          - `theme` 'light' | 'dark'
          - `density` 'normal' | 'compact'
        - `colors` object
          - `main` string, nullable, required
          - `text` string, nullable, required
          - `link` string, nullable, required
        - `features` object
          - `showBars` 'true' | 'false', nullable
          - `showUptimePercentage` 'true' | 'false', nullable, required
          - `enableFloatingStatus` 'true' | 'false', nullable
          - `showOverallUptime` 'true' | 'false', nullable
          - `showOutageUpdates` 'true' | 'false', nullable
          - `showOutageDetails` 'true' | 'false', nullable
          - `enableDetailsPage` 'true' | 'false', nullable
          - `showMonitorURL` 'true' | 'false', nullable
          - `hidePausedMonitors` 'true' | 'false', nullable
    - `id` number, required
    - `friendlyName` string, required
    - `status` unknown, required
    - `url` string, required
    - `currentStateDuration` number, required
    - `lastIncidentId` string, nullable, required
    - `userId` number, required
    - `tags` object[], required
      - `id` number, required
      - `name` string, required
      - `color` string, required
      - `monitors` object[]
        - `id` number, required
        - `friendlyName` string, nullable, required
        - `status` unknown, required
        - `url` string, required
    - `assignedAlertContacts` object[], required
      - `alertContactId` number, required
      - `threshold` number, required
      - `recurrence` number, required
    - `lastIncident` object, nullable
      - `id` string, required
      - `status` unknown, required
      - `cause` number, required
      - `reason` string, required
      - `startedAt` union, required
        - unknown
        - string
      - `duration` number, nullable, required
    - `lastDayUptimes` object, required
      - `bucketSize` number, required
      - `totalChanges` integer
      - `histogram` object[], required
        - `timestamp` number, required
        - `uptime` number, required
        - `changes` integer
    - `createDateTime` union, required
      - unknown
      - string
    - `apiKey` string, nullable, required
    - `groupId` number, nullable
    - `customFields` object, nullable

---

[API](https://skmtc.net/uptimerobot/apis/uptimerobot-api.md) · [All operations](https://skmtc.net/uptimerobot/apis/uptimerobot-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/uptimerobot/uptimerobot-api/revisions/2b6fa8c427ba/schema)