API Reference
Dashboard
  1. API Reference
  2. Box API
  3. Selling platform

Show a customer which IPs the proxy they rent had, and when

Lists successful rotations since the proxy was created, by default over the last 30 days. Use last_days, or start_date/end_date (epoch seconds). The success answer has no status field.

  • Read only
  • Selling token (?token=)
  • Public API · since v20.8.0
  • Hub: needs owner approval
  • getSellingRotationHistory
GET/selling/rotation_history

Query parameters

tokenstringrequiredsecret

API token of one sold proxy (api_token in /selling/shared_proxies). Give it only to the customer who rents that proxy; anyone with the link can use it.

last_daysintegeroptional

Look back this many days; overrides start_date and end_date.

Example 30
start_dateintegeroptional

Epoch seconds; default 30 days ago.

Example 1763251200
end_dateintegeroptional

Epoch seconds; default now.

Example 1763337600

Authentication

Authenticated only by the sold proxy's API token; the dashboard login and "Basic auth for all API" do not apply.

Responses

Rotation list or refusal.

Errors returned in msg

msgMeaningWhat to do
This function is available on Selling Platform license only. Please contact Administrator!The license does not include the Selling Platform.Upgrade the license.
API Token invalidToken unknown or reset (in message).Ask the seller for the current link; tokens change when reset.
last_days argument is not valid!last_days is not a positive integer.Send a positive integer.
start_date argument is not valid!start_date is not a positive integer.Send epoch seconds.
end_date argument is not valid!end_date is not a positive integer.Send epoch seconds.
token is missing (empty message).Send the token.
An error occurred while processing the requestUnexpected error (HTTP 500).Retry; contact the seller.
Verified against XProxy v21.3.2 on Nov 17, 2026