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.
https://jesusproxy.com/api/v1Overview
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.
| Method | Path | Purpose |
|---|---|---|
| GET | /pricing | Share and Private prices, same as dashboard checkout |
| POST | /promo/validate | Check a coupon before buying or renewing |
| GET | /balance | Wallet balance (aliases: /wallet, /me) |
| POST | /wallet/deposits | Create a crypto deposit invoice for this API key |
| GET | /wallet/deposits/:uuid | Deposit status for this API key |
| GET or POST | /sync | Refresh balance + active proxies |
| POST | /mobile-proxy/purchase | Buy proxies and receive credentials |
| GET | /proxies | List active proxies |
| GET | /proxies/:proxyId | One proxy, including health |
| POST | /proxies/:proxyId/rotate | Rotate IP now (Private only) |
| GET | /proxies/:proxyId/rotation | Read how often the IP changes |
| POST | /proxies/:proxyId/rotation | Set Private rotation interval |
| POST | /proxies/:proxyId/renew/quote | Price a renewal without charging |
| POST | /proxies/:proxyId/renew | Extend an active proxy from the wallet |
| GET or POST | /proxies/:proxyId/auto-renew | Read or turn automatic renewal on or off |
| PATCH | /proxies/:proxyId/credentials | Change proxy username and password |
| POST | /proxies/:proxyId/credentials/reset | Generate a new proxy password |
| GET | /stock | Remaining Share and Private inventory |
| GET | /proxies/:proxyId/health | Online / latency |
| GET | /proxies/:proxyId/download | TXT, JSON, OpenVPN, or WireGuard |
| GET | /orders | API 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
- Generate a key at API Keys. It starts with
jp_live_. - Add funds at Wallet. A low balance returns
402. GET /api/v1/pricing— read the current Share / Private prices.GET /api/v1/balance— check wallet funds, thenGET /api/v1/syncto pull active proxies.POST /api/v1/mobile-proxy/purchasewithplan: "private"orplan: "share".
Authentication
Authorization: Bearer jp_live_xxxxxxxxxxxxxxxxAlso 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.
| Share | Private | |
|---|---|---|
plan value | share | private |
| Protocols | One protocol — HTTP by default, or SOCKS5 if you send protocol | HTTP and SOCKS5 on the same phone |
| Credentials | One host / port / username / password | Same host, different port and username per protocol |
| Rotation | Automatic — no rotation link, rotate endpoint is blocked | Manual rotation URL plus POST …/rotate |
| VPN files | Not included | OpenVPN 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.
{
"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.
{
"coupon": "SAVE10",
"plan": "share",
"duration": "30d",
"quantity": 1
}{
"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.
{
"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.
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.
{
"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
}GET /api/v1/wallet/deposits/{uuid}
Authorization: Bearer jp_live_YOUR_KEYstatus 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.
{
"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.
| Field | Required | Notes |
|---|---|---|
plan | Yes | share or private. shared is accepted as Share. |
duration | Yes | "30d" or 30. Must exist in GET /pricing for that plan. |
country | No | ISO code. Default US. |
protocol | No | Share only: http (default) or socks5. Private always provisions both. |
session | No | rotating (default) or sticky. |
quantity | No | 1–50. Default 1. |
coupon | No | Coupon code. Also accepted as promo_code or coupon_code. Check it first with POST /promo/validate. |
carrier / location | Sometimes | Required when stock is allocated by carrier and city. |
{
"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.
{
"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.
{
"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.
{ "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.
{ "interval": "15m" }{
"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.
{
"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.
{ "enabled": true }{
"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.
{ "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.
{
"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
{ "online": true, "latency": 220 }Download
GET /api/v1/proxies/{proxyId}/download?format=txt
txt— credentials (default)json— structured credentialsopenvpn— Private only (.ovpn)wireguard— Private only (.conf)
Order History
GET /api/v1/orders?page=1&limit=10 — API purchases only.
{
"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
| HTTP | When |
|---|---|
| 400 | Invalid plan, duration, or missing carrier/location when required. |
| 401 | Missing or invalid API key. |
| 402 | Insufficient wallet. Includes required and available. |
| 403 | Wallet frozen, or a Private-only feature used on Share. |
| 404 | Proxy or deposit not found, or that duration is not sold for the plan. |
| 409 | No stock for that carrier/location. |
| 429 | Rate limit (default 100/min). |
{
"success": false,
"error": "Insufficient wallet balance",
"code": "insufficient_balance",
"required": 110,
"available": 12.5
}Examples
Get pricing
curl https://jesusproxy.com/api/v1/pricing \
-H "Authorization: Bearer jp_live_YOUR_KEY"Check balance
curl https://jesusproxy.com/api/v1/balance \
-H "Authorization: Bearer jp_live_YOUR_KEY"Buy a Private 30-day proxy
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}'