API Reference
Dashboard
  1. API Reference
  2. Box API
  3. 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.

  • Read only
  • Basic auth
  • Panel API · since v20.8.0
  • Hub: routine call
  • getRotationHistory
GET/v2/rotation_history

Query parameters

positionintegerrequired
start_dateintegerrequired

Epoch seconds.

end_dateintegerrequired

Epoch seconds.

pageintegeroptional
Default 1Example 1
limitintegeroptional
Default 10Example 10

Responses

History page or an error.

Errors returned in msg

msgMeaningWhat 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.
Verified against XProxy v21.3.2 on Nov 17, 2026