API · v1

Automate it end to end

Two ways in: per-proxy rotation links that work from anything that can make a GET request, and an authenticated REST API with scoped keys for listing and rotating lines. No SDK required — it's plain HTTP.

Rotation & status base: https://api.tmpx.io
REST API base: https://app.trumpproxies.com

Rotation links arrive with your credentials. API keys are minted in the portal (shown once, stored hashed) and are limited to 120 requests/minute.

GET/api/rotate/{token}

Rotate your proxy's IP

Requests a fresh IP for the proxy behind the token. Rotations are accepted at most once per 5 minutes per proxy; any ok:true response means your IP refresh is in progress. Works from a browser, curl, or any scheduler.

Auth: None — the token in your credential email is the secret

Request

curl https://api.tmpx.io/api/rotate/YOUR_TOKEN

Response · 200

{
  "ok": true,
  "status": "rotating",
  "message": "✅ Your IP is being updated."
}

Errors

404 unknown_tokenThe token doesn't match any proxy
403 expired / suspended / not_rotatableThe proxy can't rotate right now (plan or state)
503 offlineThe line is temporarily offline — try again shortly
502 errorRotation failed upstream — retry, then contact support

GET/api/proxy/{token}/status

Check a proxy's status

Live status for the proxy behind the token: state, endpoint, current IP where available, and time left on the term. Poll it from monitors or dashboards.

Auth: None — token-scoped

Request

curl https://api.tmpx.io/api/proxy/YOUR_TOKEN/status

Response · 200

{
  "ok": true,
  "host": "…",
  "port": 8041,
  "status": "active",
  "currentIp": "100.66.…",
  "expiresAt": "2026-08-01T00:00:00.000Z",
  "secondsLeft": 2591999
}

Errors

404Unknown token

GET/api/v1/proxiesscope: proxies:read

List your proxies

Every proxy on your account with connection details, protocol, IP version and expiry. Mint API keys in the portal under API keys; keys are rate-limited to 120 requests/minute.

Auth: Authorization: Bearer tp_live_…

Request

curl -H "Authorization: Bearer tp_live_…" \
  https://app.trumpproxies.com/api/v1/proxies

Response · 200

{
  "proxies": [
    {
      "id": "…",
      "type": "proxy",
      "status": "active",
      "host": "…",
      "port": 8041,
      "username": "…",
      "password": "…",
      "protocol": "both",
      "ip_version": "v64",
      "expires_at": "2026-08-01T00:00:00.000Z"
    }
  ]
}

Errors

401Missing or invalid API key
403Key lacks the proxies:read scope
429Rate limit exceeded — respect Retry-After

POST/api/v1/proxies/{id}/rotatescope: proxies:write

Rotate a proxy by ID

Programmatic rotation for a specific proxy. The same 5-minute acceptance window applies as the rotation link.

Auth: Authorization: Bearer tp_live_…

Request

curl -X POST -H "Authorization: Bearer tp_live_…" \
  https://app.trumpproxies.com/api/v1/proxies/PROXY_ID/rotate

Response · 200

{ "ok": true, "message": "…" }

Errors

400This proxy's plan doesn't support rotation
404Proxy not found on your account
401 / 403 / 429Auth, scope or rate-limit — as above

GET/api/v1/resellerscope: resellers:read

Reseller: list sub-accounts

For active resellers: your tier plus every sub-account and its proxies — the data behind your own storefront or billing automation.

Auth: Authorization: Bearer tp_live_…

Request

curl -H "Authorization: Bearer tp_live_…" \
  https://app.trumpproxies.com/api/v1/reseller

Response · 200

{
  "tier": "volume",
  "sub_accounts": [
    {
      "id": "…",
      "email": "customer@…",
      "name": "…",
      "proxies": [{ "id": "…", "type": "proxy", "status": "active", "host": "…", "port": 8042, "expires_at": "…" }]
    }
  ]
}

Errors

403Not an active reseller

Keys live in your portal

Create scoped keys, watch usage, and revoke anything you no longer trust — in seconds.

Manage API keys Setup guide