Skip to main content
GET
Search DNS records

Authorizations

​
X-API-Key
string
header
required

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

Query Parameters

​
q
string

InfraQL expression, limited to 8192 UTF-8 bytes after URL decoding. Omit for the dataset default query. String operators pair positive with negative: : contains and :~ does NOT contain; = is exact and != is not exact. =~ is a regular expression, which must be anchored with ^ and $ and begin with a literal prefix of at least three characters.

Maximum string length: 8192
​
limit
integer
default:50

Page size.

Required range: 1 <= x <= 200
​
offset
integer
default:0

Offset within the first 10,000 results; offset + limit must not exceed 10,000. Cannot be combined with cursor.

Required range: 0 <= x <= 9999
​
cursor
string

Opaque continuation token that expires 15 minutes after the first page and is bound to the dataset, normalized query, and resolved visibility context. Cannot be combined with offset. If it is invalid or expired, restart pagination without a cursor. Clients must not parse or persist it as a durable bookmark.

Required string length: 1 - 4096
​
sort
enum<string>

Omit for the fastest available result order. Set to recent to order records newest-first; this may be slower for broad searches.

Available options:
recent

Response

Matching DNS records.

​
pagination
object
required
​
query
string
required
Maximum string length: 8192
​
records
object[]
required
Maximum array length: 200