Bulk lookup hosts
Accepts between 1 and 100 IP addresses, canonicalizes them, deduplicates Query work, and returns one bounded item for every input position in the original order, including duplicates.
Authorizations
Infrawatch API key. Supply the complete key directly as the header value.
Body
The complete encoded JSON request body is limited to 32 KiB (32768 bytes). CIDRs, IPv6 zones, unknown fields, duplicate JSON keys, and null values are rejected.
IPs are canonicalized. Response positions preserve this array's order and duplicates.
1 - 100 elementsCanonical IPv4 or IPv6 address. CIDRs and IPv6 zones are not accepted.
64Response
Ordered, bounded host results. Per-IP failures return error items and partial=true; failure of the entire operation returns 503.
True when at least one per-IP result has status=error because bucket-local execution failed. Failure before per-IP results can be produced is returned as 503 instead.
One item per requested IP in original input order; duplicate inputs produce duplicate response positions.
1 - 100 elementsstatus=ok includes host and no error; status=not_found includes neither host nor error; status=error includes a stable error and no host.
- Option 1
- Option 2
- Option 3