---
title: "Provide ignored domains for active monitors in an account."
method: GET
path: "/v1/iris-detect/domains/ignored/"
tags: ["Iris Detect"]
---

# Provide ignored domains for active monitors in an account.

`GET /v1/iris-detect/domains/ignored/`

## Request

- Base URL: `https://api.domaintools.com`
- URL: `https://api.domaintools.com/v1/iris-detect/domains/ignored/`
- 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/domains/ignored/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.
- `changed_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.
- `discovered_before` 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.
- `discovered_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.
- `domain_state` 'active' | 'inactive'
- `escalated_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_domain_data` 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.
- `search` string: A non-empty string with a standard length limit.
- `limit` integer
- `monitor_id` string
- `mx_exists` boolean
- `offset` integer
- `order` 'asc' | 'desc'
- `preview` 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.
- `risk_score_ranges[]` string[]
- `sort[]` string[]
- `tlds[]` string[]

## Response `200`

OK

- DetectDomainList
  - `watchlist_domains` DetectDomain[]
    - `state` string
    - `domain` string
    - `status` 'active' | 'inactive'
    - `discovered_date` string, date-time
    - `changed_date` string, date-time
    - `risk_score` integer, nullable
    - `risk_score_status` string, nullable: Indicates if the risk score is 'provisional' (initial calculation) or full.
    - `risk_score_components` DetectRiskComponents
      - `proximity` integer
      - `threat_profile` union
        - DetectThreatProfile
          - `phishing` integer
          - `malware` integer
          - `spam` integer
        - unknown[]: Empty array when no threat profile data is available.
          - unknown
    - `mx_exists` boolean
    - `tld` string
    - `id` string
    - `escalations` DetectEscalation[]
      - `escalation_type` 'blocked' | 'google_safe': The type of escalation action.
      - `id` string
      - `created` string, date-time
      - `created_by` string
    - `monitor_ids` string[]
    - `name_server` object[]
      - `host` string
    - `registrant_contact_email` string[]
    - `registrar` string
    - `create_date` integer: Domain creation date in YYYYMMDD format.
    - `ip` object[]
      - `country_code` string
      - `ip` string
      - `isp` string
    - `mx` object[]
      - `host` string
  - `total_count` integer
  - `count` integer
  - `offset` integer
  - `limit` integer

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