subnethistory docs
Open the appApp
Getting started/Your first lookup

Your first lookup

What you can search, why a cold lookup is slow, and why the second is instant.

subnethistory.com and the API return the same report. No account, nothing to install.

Query typeExamples
IPv4 address8.8.8.8
IPv6 address2606:4700::1111
IPv4 prefix8.8.8.0/24
IPv6 prefix2001:db8::/32
AS numberAS15169, 15169

IPv6 input is normalised. Looking up a single address returns address level facts plus its covering block; look up the block itself for its history.

i

Private and reserved space (10.0.0.0/8, 127.0.0.1, CGNAT) is answered instantly: no holder, no history.

Run your first lookup

Search on the site. The API returns the same report as JSON, with no key:

curl
curl "https://subnethistory.com/api/v1/lookup?q=8.8.8.8"

First lookups take longer

A cold lookup can take about 30 seconds; repeats come from cache in milliseconds. A partial report sets meta.partial and says how long to wait in meta.retryAfterMs. The streaming endpoint emits progress instead.

Where next

Reading a report and the API reference.

Last updated 2026-08-15subnethistory.com