- API Reference
- Box API
- 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.
GET
/selling/rotation_historyQuery 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
30start_dateintegeroptional
Epoch seconds; default 30 days ago.
Example
1763251200end_dateintegeroptional
Epoch seconds; default now.
Example
1763337600Authentication
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.
Unexpected error.
statusbooleanoptional
messagestringoptional
datastringoptional
Errors returned in msg
| msg | Meaning | What 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 invalid | Token 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 request | Unexpected error (HTTP 500). | Retry; contact the seller. |