Developers

JesusProxy API Documentation

Buy and manage Jesus Proxy Share and Private mobile proxies. Create a key under API Keys, fund your wallet, then call POST /api/v1/mobile-proxy/purchase.

Base URLhttps://jesusproxy.com/api/v1

Overview

Every request needs a secret API key. Purchases debit the wallet at the same Share and Private prices as dashboard checkout. GET /pricing returns those amounts. Default rate limit is 100 requests/minute. Private rotation from code is also covered on rotating mobile proxies.

MethodPathPurpose
GET/pricingShare and Private prices, same as dashboard checkout
POST/promo/validateCheck a coupon before buying or renewing
GET/balanceWallet balance (aliases: /wallet, /me)
POST/wallet/depositsCreate a crypto deposit invoice for this API key
GET/wallet/deposits/:uuidDeposit status for this API key
GET or POST/syncRefresh balance + active proxies
POST/mobile-proxy/purchaseBuy proxies and receive credentials
GET/proxiesList active proxies
GET/proxies/:proxyIdOne proxy, including health
POST/proxies/:proxyId/rotateRotate IP now (Private only)
GET/proxies/:proxyId/rotationRead how often the IP changes
POST/proxies/:proxyId/rotationSet Private rotation interval
POST/proxies/:proxyId/renew/quotePrice a renewal without charging
POST/proxies/:proxyId/renewExtend an active proxy from the wallet
GET or POST/proxies/:proxyId/auto-renewRead or turn automatic renewal on or off
PATCH/proxies/:proxyId/credentialsChange proxy username and password
POST/proxies/:proxyId/credentials/resetGenerate a new proxy password
GET/stockRemaining Share and Private inventory
GET/proxies/:proxyId/healthOnline / latency
GET/proxies/:proxyId/downloadTXT, JSON, OpenVPN, or WireGuard
GET/ordersAPI purchases, renewals, and auto-renewals

Dashboard session routes under /wallet-api/ are not this API. Public automation uses /api/v1 with a Bearer key.

Quick start

  1. Generate a key at API Keys. It starts with jp_live_.
  2. Add funds at Wallet. A low balance returns 402.
  3. GET /api/v1/pricing — read the current Share / Private prices.
  4. GET /api/v1/balance — check wallet funds, then GET /api/v1/sync to pull active proxies.
  5. POST /api/v1/mobile-proxy/purchase with plan: "private" or plan: "share".

Authentication

HTTP header
Authorization: Bearer jp_live_xxxxxxxxxxxxxxxx

Also accepted: X-API-Key or X-JesusProxy-Key. Legacy keys may start with JR_API_. Missing or invalid keys return 401.

Share vs Private

These are the only products. After a successful order, the dashboard and this API return the same credentials.

SharePrivate
plan valueshareprivate
ProtocolsOne protocol — HTTP by default, or SOCKS5 if you send protocolHTTP and SOCKS5 on the same phone
CredentialsOne host / port / username / passwordSame host, different port and username per protocol
RotationAutomatic — no rotation link, rotate endpoint is blockedManual rotation URL plus POST …/rotate
VPN filesNot includedOpenVPN and WireGuard downloads

Get Pricing

GET /api/v1/pricing

Keys are share and private. Only durations you can buy on the dashboard are listed (currently 1, 7, and 30 days). The 30-day plan is the best value. The charge is the same amount as dashboard checkout.

Response shape
{
  "share": { "1d": 3, "7d": 20, "30d": 65 },
  "private": { "1d": 6, "7d": 35, "30d": 110 }
}

These match dashboard buy prices. If an admin changes a plan price, GET /pricing and purchase use the new amount.

Coupon

POST /api/v1/promo/validate checks a code and does not charge the wallet.

The same coupon works for every package on sale: share and private, for 1d, 7d, and 30d. Change plan and duration. A code limited to one customer still requires that account’s API key.

To apply it, send the same coupon on POST /api/v1/mobile-proxy/purchase or POST /api/v1/proxies/{proxyId}/renew. An invalid code returns 400 and nothing is purchased. promo_code and coupon_code are accepted as the same field.

Check a coupon
{
  "coupon": "SAVE10",
  "plan": "share",
  "duration": "30d",
  "quantity": 1
}
Valid response
{
  "success": true,
  "valid": true,
  "code": "SAVE10",
  "subtotal": 65,
  "discount": 6.5,
  "total": 58.5,
  "message": "Promo applied."
}

Check Balance

GET /api/v1/balance

Same payload is also returned from /wallet, /wallet/balance, /wallet/summary, /account, /account/balance, and /me.

Response
{
  "success": true,
  "balance": 42.5,
  "currency": "USD",
  "frozen": false,
  "pendingDeposits": 0,
  "totalDeposited": 200,
  "activeProxies": 3
}

Deposits

A jp_live_ key can fund its own wallet. No dashboard session is required. POST /api/v1/wallet/deposits creates a Cryptomus invoice. Send the customer to paymentUrl, or show address. Then poll GET /api/v1/wallet/deposits/{uuid} until credited is true. The path accepts the invoice uuid, the deposit id, or the txnCode. Resellers can add url_return and url_success so the customer comes back to the site where they started payment. Leave them off to return to JesusProxy.

The key can read only its own deposits. Another account's invoice returns 404.

Create a deposit
POST /api/v1/wallet/deposits
Authorization: Bearer jp_live_YOUR_KEY
Content-Type: application/json

{
  "amountUsd": 50,
  "url_return": "https://their-domain.com/wallet",
  "url_success": "https://their-domain.com/wallet/success"
}

url_return and url_success are optional. A request with only amountUsd still works. Both values must be public https links. url_return is the Return to Store button. url_success is the page after payment.

201 response
{
  "success": true,
  "id": "dep_…",
  "uuid": "cryptomus-invoice-uuid",
  "txnCode": "TXN-…",
  "amountUsd": 50,
  "currency": "USD",
  "status": "pending",
  "displayStatus": "Pending",
  "address": "crypto-address",
  "paymentUrl": "https://pay.cryptomus.com/…",
  "credited": false,
  "expiresAt": "2026-10-11T10:00:00.000Z",
  "balance": 42.5
}
Check status
GET /api/v1/wallet/deposits/{uuid}
Authorization: Bearer jp_live_YOUR_KEY

status becomes paid after Cryptomus confirms the payment, and credited is true once the wallet balance includes it.balance is the wallet after that credit. An amount below the dashboard minimum returns 400. A frozen wallet returns 403.

Sync

GET /api/v1/sync or POST /api/v1/sync

Read-only snapshot for a client panel: current wallet plus every active proxy. It does not rotate IPs or change credentials.

Response
{
  "success": true,
  "balance": 42.5,
  "currency": "USD",
  "frozen": false,
  "pendingDeposits": 0,
  "totalDeposited": 200,
  "activeProxies": 1,
  "syncedAt": "2026-09-22T09:15:00.000Z",
  "total": 1,
  "proxies": [
    {
      "proxyId": "PX-10038",
      "plan": "Private · 30 Days",
      "packageType": "private",
      "protocol": "HTTP/SOCKS5",
      "host": "xxxx.nd.jpxdx.net",
      "port": 8147,
      "username": "user_http",
      "accesses": { "http": { "host": "xxxx.nd.jpxdx.net", "port": 8147 }, "socks5": { "host": "xxxx.nd.jpxdx.net", "port": 9099 } },
      "rotationUrl": "https://rt.jpxdx.net/…",
      "status": "active"
    }
  ]
}

Buy Proxy

POST /api/v1/mobile-proxy/purchase — HTTP 201 on success. Quantity 1–50.

FieldRequiredNotes
planYesshare or private. shared is accepted as Share.
durationYes"30d" or 30. Must exist in GET /pricing for that plan.
countryNoISO code. Default US.
protocolNoShare only: http (default) or socks5. Private always provisions both.
sessionNorotating (default) or sticky.
quantityNo1–50. Default 1.
couponNoCoupon code. Also accepted as promo_code or coupon_code. Check it first with POST /promo/validate.
carrier / locationSometimesRequired when stock is allocated by carrier and city.
Request body
{
  "plan": "private",
  "duration": "30d",
  "country": "US",
  "session": "rotating",
  "quantity": 1,
  "coupon": "SAVE10"
}

A Private order returns the same thing a customer sees on My Proxies: HTTP URL, SOCKS5 URL (different port and username), and a rotation link.

Private success (201)
{
  "success": true,
  "orderId": "JR-ORD-10038",
  "proxyId": "PX-10038",
  "plan": "Private · 30 Days",
  "packageType": "private",
  "protocol": "HTTP/SOCKS5",
  "session": "Rotating",
  "host": "xxxx.nd.jpxdx.net",
  "port": 8147,
  "username": "user_http",
  "password": "secret",
  "accesses": {
    "http": {
      "host": "xxxx.nd.jpxdx.net",
      "port": 8147,
      "username": "user_http",
      "password": "secret"
    },
    "socks5": {
      "host": "xxxx.nd.jpxdx.net",
      "port": 9099,
      "username": "user_socks",
      "password": "secret2"
    }
  },
  "connectionStrings": {
    "http": "http://user_http:secret@xxxx.nd.jpxdx.net:8147",
    "socks5": "socks5://user_socks:secret2@xxxx.nd.jpxdx.net:9099"
  },
  "rotationUrl": "https://rt.jpxdx.net/…",
  "capabilities": {
    "http": true,
    "socks5": true,
    "openvpn": true,
    "wireguard": true,
    "manual_rotation": true
  },
  "country": "United States",
  "countryCode": "US",
  "carrier": "tmobile",
  "location": "new-york",
  "expiresAt": "2026-10-15",
  "proxies": [ { "proxyId": "PX-10038", "…": "same fields as above" } ],
  "balance": 42.5
}

Top-level host / port / username are the HTTP access. Always read accesses.socks5 for the SOCKS5 login — it is not the same username or port. balance is the wallet remaining after the debit.

Share success (201) — HTTP example
{
  "success": true,
  "proxyId": "PX-10009",
  "plan": "Share · 1 Day",
  "packageType": "share",
  "protocol": "HTTP",
  "accesses": {
    "http": {
      "host": "xxxx.nd.jpxdx.net",
      "port": 8081,
      "username": "user_http",
      "password": "secret"
    },
    "socks5": null
  },
  "connectionStrings": {
    "http": "http://user_http:secret@xxxx.nd.jpxdx.net:8081",
    "socks5": null
  },
  "rotationUrl": null,
  "capabilities": {
    "http": true,
    "socks5": false,
    "openvpn": false,
    "wireguard": false,
    "manual_rotation": false
  }
}

List Proxies

GET /api/v1/proxies?page=1&limit=10 — active proxies only. limit is 1–100.

Each result uses the same credential fields as purchase: plan, packageType, accesses, connectionStrings, rotationUrl, capabilities.

Get Single Proxy

GET /api/v1/proxies/{proxyId} — same body as a list item, plus health. Unknown id returns 404.

Rotate Proxy

POST /api/v1/proxies/{proxyId}/rotate

Private only. You can also open rotationUrl. Share proxies rotate automatically and this call returns an error.

Response
{ "success": true }

IP rotation interval

GET /api/v1/proxies/{proxyId}/rotation

POST /api/v1/proxies/{proxyId}/rotation

Private proxies can use manual, 5m, 15m, 30m, or 1h. manual waits for POST …/rotate or the rotation link. Share proxies rotate on the shared pool schedule. You can read that interval, but you cannot change it for one Share proxy.

Set a Private interval
{ "interval": "15m" }
Private response
{
  "success": true,
  "proxyId": "PX-10024",
  "packageType": "private",
  "editable": true,
  "rotationEnabled": true,
  "interval": "15m",
  "intervals": ["manual", "5m", "15m", "30m", "1h"]
}

Renew a proxy

POST /api/v1/proxies/{proxyId}/renew/quote returns the price and does not charge.

POST /api/v1/proxies/{proxyId}/renew debits the wallet and extends expiry. Send duration as 1d, 7d, or 30d. The proxy stays Share or Private. If you omit duration, a proxy already on 1, 7, or 30 days renews for that same length. A 3-day proxy must include duration, because 3 days is no longer sold. Add coupon to apply a code to the renewal.

Renew response
{
  "success": true,
  "orderId": "MP-1042",
  "proxyId": "PX-10024",
  "amountUsd": 65,
  "balance": 35,
  "expiresAt": "2026-11-04T12:00:00.000Z"
}

A low balance returns 402. The amount matches dashboard renewal for that plan.

Auto-renewal

GET /api/v1/proxies/{proxyId}/auto-renew

POST /api/v1/proxies/{proxyId}/auto-renew

Auto-renew is off until you enable it. When it is on, the same plan is renewed from the wallet during the last 6 hours before expiry. A promo code assigned to the account email is applied automatically. If the balance is too low, the proxy is not extended and the next try waits an hour. The dashboard switch starts off. The customer turns it on only if they want automatic renewal.

Enable
{ "enabled": true }
Response
{
  "success": true,
  "proxyId": "PX-10024",
  "enabled": true,
  "expiresAt": "2026-11-04T12:00:00.000Z"
}

Credentials

PATCH /api/v1/proxies/{proxyId}/credentials updates the live proxy username, password, or both.

POST /api/v1/proxies/{proxyId}/credentials/reset keeps the username and sets a new password on the proxy.

Update
{ "username": "newuser", "password": "new-password" }

The response includes the current username, password, and accesses. An inactive proxy cannot be changed.

Stock

GET /api/v1/stock

Optional ?plan=share or ?plan=private. Counts are the proxies still available to buy, grouped by carrier and location.

Response
{
  "success": true,
  "configured": true,
  "share": {
    "available": true,
    "remaining": 12,
    "carriers": [
      { "id": "t-mobile", "name": "T-Mobile", "remaining": 8, "locations": [] }
    ]
  },
  "private": { "available": true, "remaining": 4, "carriers": [] }
}

IP authorization

IP whitelisting is not available. A proxy accepts the username and password from purchase or PATCH …/credentials. Access is not limited to a source IP, and there is no whitelist endpoint.

Health Check

GET /api/v1/proxies/{proxyId}/health

Response
{ "online": true, "latency": 220 }

Download

GET /api/v1/proxies/{proxyId}/download?format=txt

  • txt — credentials (default)
  • json — structured credentials
  • openvpn — Private only (.ovpn)
  • wireguard — Private only (.conf)

Order History

GET /api/v1/orders?page=1&limit=10 — API purchases only.

Response
{
  "results": [
    {
      "orderId": "JR-ORD-10038",
      "plan": "Private · 30 Days",
      "packageType": "private",
      "country": "United States",
      "countryCode": "US",
      "quantity": 1,
      "durationDays": 30,
      "amountUsd": 110,
      "status": "active",
      "proxyIds": ["PX-10038"],
      "createdAt": "2026-09-15T13:20:07.485Z",
      "expiresAt": "2026-10-15T13:20:07.485Z"
    }
  ],
  "page": 1,
  "pages": 1,
  "total": 1,
  "limit": 10
}

Errors

HTTPWhen
400Invalid plan, duration, or missing carrier/location when required.
401Missing or invalid API key.
402Insufficient wallet. Includes required and available.
403Wallet frozen, or a Private-only feature used on Share.
404Proxy or deposit not found, or that duration is not sold for the plan.
409No stock for that carrier/location.
429Rate limit (default 100/min).
402 example
{
  "success": false,
  "error": "Insufficient wallet balance",
  "code": "insufficient_balance",
  "required": 110,
  "available": 12.5
}

Examples

Get pricing

curl
curl https://jesusproxy.com/api/v1/pricing \
  -H "Authorization: Bearer jp_live_YOUR_KEY"

Check balance

curl
curl https://jesusproxy.com/api/v1/balance \
  -H "Authorization: Bearer jp_live_YOUR_KEY"

Buy a Private 30-day proxy

curl
curl -X POST https://jesusproxy.com/api/v1/mobile-proxy/purchase \
  -H "Authorization: Bearer jp_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{  "plan": "private",  "duration": "30d",  "country": "US",  "session": "rotating",  "quantity": 1}'