Multi-condition PADNS Lookup

qtype

string

Yes

Specifies the DNS record type to query. Supported types:

• a: IPv4 address

• aaaa: IPv6 address

• cname: Canonical name

• mx: Mail exchange

• ns: Name server

• ptr4: IPv4 reverse lookup

• tr6: IPv6 reverse lookup

qname

string

Yes

The primary name or IP address to look up.

• Supports wildcards (*) in names.

• Accepts IPv4 or IPv6 addresses.

qanswer

string

Yes

The expected answer or IP address to match against.

• Supports wildcards (*) in names.

• Accepts IPv4 or IPv6 addresses.

match

string

No

Filters records where the query equals qname and the answer matches or does not match qanswer.

• eq (default): Answer must match qanswer.

• neq: Answer must not match qanswer.

name

string

No

Additional names to match against qanswer.

• Up to 5 names allowed.

• Wildcards (*) supported.

netmask

int

No

Network mask for qtype=a or aaaa queries to find records in the same subnet.

• Defaults: IPv4=32, IPv6=128.

net

string

No

For ptr4 or a records, filters IPv4 addresses in or out of the subnet defined by netmask.

• in (default): Include records in subnet.

• notin: Exclude records in subnet.

network

string

No

Additional subnets to filter by (format: 1.1.1.1/24).

• Up to 5 networks allowed.

asnum

int

No

AS (Autonomous System) number to search for.

• Can be repeated for multiple ASNs.

• Used with qtype=a or ptr4 to find records in the same AS.

asn

string

No

For ptr4 or a records, filters IPv4 addresses in or out of the ASN defined by asnum.

• in (default): Include records in ASN.

• notin: Exclude records in ASN.

asname

string

No

Search all AS numbers where the AS name begins with the given value.

asname_starts_with

string

No

Search all AS numbers where the AS name starts with the given value.

asname_contains

string

No

Search all AS numbers where the AS name contains the given value.

first_seen_after

string/int

No

Records where first_seen timestamp is on or after the specified time.

first_seen_before

string/int

No

Records where first_seen timestamp is on or before the specified time.

last_seen_after

string/int

No

Records where last_seen timestamp is on or after the specified time.

last_seen_before

string/int

No

Records where last_seen timestamp is on or before the specified time.

as_of

string/int

No

Only include records where the equivalent timestamp falls between first_seen and last_seen.

sort

string

No

Orders results by column. Can be repeated for multi-level sorting. Sort columns:

• last_seen, last, time_last (synonyms for last seen).

• first_seen, first, time_first (synonyms for first seen).

• query, rrname (synonyms for query).

• answer, rdata (synonyms for answer).

Order directions:

• asc, +, up (ascending).

• desc, -, down (descending).

output_format

string

No

Output format.

• padns (default): Silent Push padns format.  

• cof: Common output format.

limit

int

No

Maximum number of results to return.  

• Default: 100.

skip

int

No

Number of results to skip (for pagination).

prefer

string

No

Response preference.

• result (default): Wait for results (up to max_wait), then return

• job_id if needed.

• job_id: Return job ID immediately.

max_wait

int

No

Seconds to wait for results before returning job ID.

• Default: 25.

• Range: 0–25.

with_metadata

int

No

Include metadata (e.g., total results, job ID) in response.

• 0 (default): Exclude.

• 1: Include.

X-API-KEY

API key for authentication.