Skip to main content
POST
Summarize DNS records and distinct names

Authorizations

X-API-Key
string
header
required

Infrawatch API key. Supply the complete key directly as the header value.

Body

application/json

The complete encoded JSON request body is limited to 16 KiB (16384 bytes). Unknown fields, duplicate JSON keys, and null values are rejected.

aggregation
object
query
string

DNS InfraQL query; an omitted or empty value matches all current DNS records.

Maximum string length: 8192

Response

Closed DNS record and distinct-name analytics summary.

dns_names
integer<int64>
required
Required range: 0 <= x <= 9007199254740991
dns_names_relation
enum<string>
required

Exact only for a proven empty result; otherwise a bounded cardinality estimate.

Available options:
eq,
approx
dns_records
integer<int64>
required
Required range: 0 <= x <= 9007199254740991
dns_records_relation
string
required
Allowed value: "eq"
query
string
required
Maximum string length: 8192
group
object