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.
What you can search
| Query type | Examples |
|---|---|
| IPv4 address | 8.8.8.8 |
| IPv6 address | 2606:4700::1111 |
| IPv4 prefix | 8.8.8.0/24 |
| IPv6 prefix | 2001:db8::/32 |
| AS number | AS15169, 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