XProxy Official
  1. Rotation (Change IP)
XProxy Official
  • API document for XProxy service
  • Proxy Management
    • Get the list of devices & proxies information
      GET
    • Get status of a specific proxy
      GET
    • Get status of a specific position
      GET
    • Reboot dongle with specific proxy
      GET
    • Reboot dongle with specific position
      GET
  • Device Management
    • Change IMEI for multiple dongles
      POST
    • Add or change device note
      POST
    • Change MAC address for dongles
      POST
    • Change APN for dongles
      POST
    • Change device label
      POST
    • Connect dongle to network
      POST
    • Enable/disable WiFi for multiple dongles
      POST
    • Disconnect dongle from network
      POST
    • Reboot a specific dongle
      POST
    • Reset bus dongle
      POST
    • Get dongle information including phone number
      POST
    • Set MTU value for a dongle
      POST
  • Rotation (Change IP)
    • Manual rotation :: Rotate IP for a specific proxy or SOCKS port
      GET
    • Manual rotation :: Rotate IP for a specific position of modem in list
      GET
    • Auto rotation :: Add a rotation schedule job
      POST
    • Auto rotation :: Retrieve scheduled rotation jobs
      POST
  • Selling Platform
    • Get list of selling proxies
      GET
    • Generate selling proxies
      POST
    • Editing for single selling proxy port
      POST
    • Delete selling proxy by ID
      POST
  • SMS & USSD Utitlies
    • SMS
      • Read SMS messages
      • Send SMS message
      • Delete SMS messages
    • USSD
      • Send USSD command
      • Read USSD response
  • System Management
    • Restart XProxy Panel
    • Reboot XProxy System
  1. Rotation (Change IP)

Auto rotation :: Retrieve scheduled rotation jobs

POST
{{BASE_URL}}/v2/schedule/rotation_jobs
This endpoint retrieves scheduled rotation jobs based on positions.

Request

Body Params application/json
positions
array[integer]
optional
An array of modem positions in the device list to retrieve jobs for.
Example:
[1]
page
integer 
optional
The page number of the results to fetch.
Example:
1
limit
integer 
optional
The number of results per page.
Example:
5
Example
{
    "positions": [
        1
    ],
    "page": 1,
    "limit": 5
}

Request samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location -g --request POST 'http://localhost/v2/schedule/rotation_jobs' \
--header 'Content-Type: application/json' \
--data-raw '{
    "positions": [
        1
    ],
    "page": 1,
    "limit": 5
}'

Responses

🟢200OK
application/json
Successfully retrieved the scheduled rotation jobs.
Body
status
boolean 
optional
Example:
true
data
object 
optional
data
array [object {11}] 
optional
total
integer 
optional
The total number of scheduled jobs.
Example:
2
Example
{
    "status": true,
    "data": {
        "data": [
            {
                "id": 3,
                "position": 1,
                "interval": 5,
                "unit": "minutes",
                "specific_time": "00:00",
                "start_time": null,
                "end_time": null,
                "enabled": 1,
                "stamp_created": 1741690306,
                "type": "system",
                "next_run": 1741690800
            }
        ],
        "total": 2
    }
}
🟠400Bad Request
🔴500Server Error
Modified at 2025-04-23 02:56:43
Previous
Auto rotation :: Add a rotation schedule job
Next
Get list of selling proxies
Built with