---
title: "List tracked domains"
method: GET
path: "/v1/domains"
---

# List tracked domains

`GET /v1/domains`

## Request

- Base URL: `https://domaindrift.io`
- URL: `https://domaindrift.io/v1/domains`
- Auth: API key in header `X-DomainDrift-Key`

Paginated list of domains in the catalog. Filter by category or search by name.

## Query parameters

- `category` string
- `q` string
- `page` integer
- `limit` integer
- `format` 'json' | 'csv'

## Response `200`

Paginated domain list (JSON), or a text/csv download when format=csv

- object
  - `domains` DomainSummary[]
    - `domain` string
    - `category` string, nullable
    - `last_scanned_at` string, date-time, nullable
    - `scan_count` integer
    - `ping_ms` number, nullable
    - `http_status` integer, nullable
    - `probe_verdict` 'ok' | 'redirect' | 'bot_blocked' | 'not_found' | 'method_blocked' | 'rate_limited' | 'client_error' | 'server_error' | 'cf_blocked' | 'no_response' | 'timeout' | 'tls_error' | 'connection_refused' | 'network_error' | 'dns_failed' | 'nxdomain' | 'dns_servfail' | 'dns_refused' | 'dns_timeout' | 'dns_empty', nullable
    - `subdomain_count` integer
    - `service_count` integer
    - `has_dnssec` 0 | 1 | null, nullable
    - `dnssec_ok_at` string, nullable: When the DNSSEC plane last succeeded. NULL means has_dnssec is unmeasured, not false.
    - `has_ipv6` boolean
    - `complexity_score` number
  - `pagination` object
    - `page` integer
    - `limit` integer
    - `total` integer
    - `pages` integer

---

[API](https://skmtc.dev/domaindrift/apis/domaindrift-continuous-internet-telemetry-api.md) · [All operations](https://skmtc.dev/domaindrift/apis/domaindrift-continuous-internet-telemetry-api/llms.txt) · [OpenAPI document](https://skmtc.dev/domaindrift/apis/domaindrift-continuous-internet-telemetry-api/revisions/eb8e3f45736c?raw)
