API Documentation

Control your proxy programmatically over HTTP: rotate the IP, read received SMS and change the OS spoof. Authenticate with Basic Auth using your proxy credentials. The examples below use USER:PASS placeholders.

Authentication

Every request must include an Authorization: Basic <base64(user:pass)> header. Authorization: Basic <base64(user:pass)>

The examples use USER:PASS as placeholders. Your real proxy credentials appear in your account once you have a proxy — they are never shown on this public page.

Base URL : https://frproxy.com

GET POST /api/v1/rotate Manual IP rotation

Requests an immediate IP change. The new IP is assigned by the carrier (may take a few seconds).

🔗 Rotation link (browser)

Open this link in a browser or paste it into your tool: each open changes the IP (rotation available via GET).

https://USER:PASS@frproxy.com/api/v1/rotate
curl -s -X POST \
  -u "USER:PASS" \
  https://frproxy.com/api/v1/rotate

Python

import requests
r = requests.post(
    "https://frproxy.com/api/v1/rotate",
    auth=("USER", "PASS")
)
print(r.json())  # {"status":"ok"}

Response : {"status":"ok"}

POST /api/v1/reboot Modem reboot

Physically reboots the 4G modem. Reconnection usually takes 30–60 seconds.

curl -s -X POST \
  -u "USER:PASS" \
  https://frproxy.com/api/v1/reboot

Response : {"status":"ok"}

GET /api/v1/sms Read received SMS

Returns the list of SMS received on the SIM linked to your proxy.

curl -s \
  -u "USER:PASS" \
  https://frproxy.com/api/v1/sms

Example response

[
  {
    "from": "+33600000000",
    "text": "Your code is 123456",
    "date": "2026-06-11T10:30:00Z"
  }
]
POST /api/v1/spoof Change Spoof OS

Changes the simulated OS in proxy headers. Parameter os: windows, linux, macos, android, ios, or empty to disable.

curl -s -X POST \
  -u "USER:PASS" \
  "https://frproxy.com/api/v1/spoof?os=windows"
🪟 windows
🐧 linux
🍎 macos
🤖 android
📱 ios
⊘ (Disabled)

Response : {"status":"ok","os":"windows"}

Response codes

200Success
401Missing or invalid credentials
403Feature not enabled on your proxy (e.g. spoof OS)
502Proxy engine temporarily unreachable
keyCreate an account to get your credentials sellVIEW PLANS