API Documentation & IP Rotation
Programmatically trigger 4G/5G mobile IP rotations from your scraping scripts and automated browsers in under 3 seconds.
Direct Answer / API Summary
Programmatically trigger 4G/5G mobile IP rotations from your scraping scripts and automated browsers in under 3 seconds. Use the Proxym REST API with your Bearer API token to programmatically trigger 4G/5G mobile IP rotations in under 3 seconds with zero connection drops.
Authentication & Security
All REST API endpoints require a Bearer token in the Authorization header. Generate your live token in Dashboard > API Keys.
Authorization: Bearer ps_live_xxxxxxxxx
IP Rotation (Force Tower Handshake)
POSTThis endpoint instructs your dedicated physical 5G modem to execute an airplane-mode toggle, reconnecting to the nearest ISP cellular tower with a fresh residential IP in 3-8 seconds.
URL Parameters
| Parameter | Type | Description |
|---|---|---|
| assignment_id | String (UUID) | The unique ID of your proxy assignment (visible on your dashboard). |
cURL Request Example
curl -X POST https://api.proxym.io/v1/proxies/550e8400-e29b-41d4-a716-446655440000/rotate \
-H "Authorization: Bearer ps_live_abc123..." \
-H "Content-Type: application/json"Response (200 OK)
{
"success": true,
"message": "IP rotated successfully. It may take up to 10 seconds to stabilize."
}