- API Reference
- Box API
- Proxy settings
Page through every public IP the modems have had, with reuse scores
Returns the full public-IP history (no time window), grouped by IP, with how often each IP came back. score drops by one per repeat; freshness is fresh when the score is at or above the IP history guard's threshold, else warning. Summary fields cover all IPs matching search.
/v2/ip_poolsQuery parameters
Page number from 1.
1Example 1Rows per page (1–200).
50Example 50Filter on the IP text.
203.0.113Authentication
Needs a trusted caller (loopback, LAN unless "force auth for local" is on, whitelisted IP, allowed Tailscale) or valid dashboard Basic credentials, which are checked only when dashboard authentication is enabled.
Responses
One page of IPs, or status false with the error text.
Percent of IPs on this page that are fresh.
fresh, warning, stale, unknownUnix time (seconds).
Unix time (seconds).
The caller is not trusted (not loopback, LAN, whitelisted or allowed Tailscale) and sent no valid Basic credentials. The body depends on whether "Basic auth for all API" is on. Routes that also use the panel login can answer a plain-text 401 "Unauthorized Access" instead.
Errors returned in msg
| msg | Meaning | What to do |
|---|---|---|
(exception text) | Reading the IP history failed. | Retry; check the controller log if it persists. |