- API Reference
- Box API
- Rotation settings
List past IP rotations of one slot in a time range
Use this to audit when a slot rotated, which IP it got and how long it took. Only rotations with a public IPv4 are listed, newest first. When Smart IP Guard is on, each row also has the IP score and freshness. A missing or non-numeric position, start_date or end_date returns status false with a generic message.
/v2/rotation_historyQuery parameters
Epoch seconds.
Epoch seconds.
1Example 110Example 10Responses
History page or an error.
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.
Unhandled error, for example a non-integer position or a missing required parameter.
Error name, e.g. internal_server_error or bad_request.
Errors returned in msg
| msg | Meaning | What to do |
|---|---|---|
Have an error during request! Contact administrator! | A parameter is missing or not a number or the database query failed. | Send integer position and epoch-second dates. |