---
title: "Retrieves monitors and monitor IDs for an account."
method: GET
path: "/v1/iris-detect/monitors/"
tags: ["Iris Detect"]
---

# Retrieves monitors and monitor IDs for an account.

`GET /v1/iris-detect/monitors/`

## Request

- Base URL: `https://api.domaintools.com`
- URL: `https://api.domaintools.com/v1/iris-detect/monitors/`
- Auth: one of:
  - API key in header `X-Api-Key`
  - HTTP basic
  - API key in query parameter `signature`
- TypeScript: <https://skmtc.dev/domaintools/apis/domaintools-iris-api/docs/v1/iris-detect/monitors/get.ts> (a function with typed inputs; its response is checked against the schema)

## Query parameters

- `app_name` string: A short identifier, code, or handle.
- `app_partner` string: A short identifier, code, or handle.
- `app_version` string: A short identifier, code, or handle.
- `datetime_counts_since` union: Defines a point in time for filtering results. Accepts one of: - relative time, in negative seconds - absolute time, in an ISO 8601 timestamp
  - integer: Relative offset in seconds before the current UTC time. Must be between -1 (1 second ago) and -432000 (5 days ago).
  - string, date-time: ISO 8601 datetime in UTC format with no milliseconds or timezone offset. Format: `YYYY-MM-DDTHH:MM:SSZ`. The timestamp must represent a point between *1 second ago* and *5 days ago*, relative to the current UTC time.
- `include_counts` boolean: An optional boolean flag that enables a specific feature or response extension when set to `true`. If `false` or omitted, the feature is ignored.
- `limit` integer
- `offset` integer
- `order` 'asc' | 'desc'
- `sort[]` 'term' | 'created_date' | 'domain_counts_changed' | 'domain_counts_discovered'

## Response `200`

OK. A list of monitors was successfully retrieved.

- MonitorList: A list of Iris Detect monitors and associated metadata.
  - `total_count` integer
  - `offset` integer
  - `limit` integer
  - `monitors` Monitor[]
    - `term` string
    - `match_substring_variations` boolean
    - `nameserver_exclusions` string[]
    - `text_exclusions` string[]
    - `id` string
    - `created_date` string, date-time
    - `updated_date` string, date-time
    - `state` 'active' | 'inactive'
    - `status` string
    - `domain_counts` MonitorDomainCounts: Counts of domains associated with a monitor in various states.
      - `new` integer: The number of new domains discovered.
      - `watched` integer: The number of domains currently on the watchlist.
      - `escalated` integer: The number of domains that have been escalated.
      - `changed` integer: The number of watched domains that have changed.
    - `created_by` string

## Other responses

- `400`: 400: Bad Request. The request was invalid. The response will contain details about the error.
- `401`: 401: Unauthorized. API credentials are required and were not provided, or the provided credentials are not valid.
- `403`: 403: Forbidden. The API credentials provided do not have access to the requested resource or endpoint.
- `404`: 404: Not Found. The requested resource does not exist.

---

[API](https://skmtc.dev/domaintools/apis/domaintools-iris-api.md) - [All operations](https://skmtc.dev/domaintools/apis/domaintools-iris-api/llms.txt) - [OpenAPI document](https://skmtc.dev/domaintools/apis/domaintools-iris-api/revisions/74a0d057a130?raw)