Get order
curl --request GET \
--url https://api.proxyjam.com/public/v1/orders/{order_id} \
--header 'X-API-Key: <api-key>'import requests
url = "https://api.proxyjam.com/public/v1/orders/{order_id}"
headers = {"X-API-Key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};
fetch('https://api.proxyjam.com/public/v1/orders/{order_id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.proxyjam.com/public/v1/orders/{order_id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"X-API-Key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.proxyjam.com/public/v1/orders/{order_id}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("X-API-Key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.proxyjam.com/public/v1/orders/{order_id}")
.header("X-API-Key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.proxyjam.com/public/v1/orders/{order_id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["X-API-Key"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"payment_url": "<string>"
}Orders
Get order
Retrieve the details of a specific order.
GET
/
orders
/
{order_id}
Get order
curl --request GET \
--url https://api.proxyjam.com/public/v1/orders/{order_id} \
--header 'X-API-Key: <api-key>'import requests
url = "https://api.proxyjam.com/public/v1/orders/{order_id}"
headers = {"X-API-Key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};
fetch('https://api.proxyjam.com/public/v1/orders/{order_id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.proxyjam.com/public/v1/orders/{order_id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"X-API-Key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.proxyjam.com/public/v1/orders/{order_id}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("X-API-Key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.proxyjam.com/public/v1/orders/{order_id}")
.header("X-API-Key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.proxyjam.com/public/v1/orders/{order_id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["X-API-Key"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"payment_url": "<string>"
}Returns full details for a single order, including proxy credentials once the order is
provisioned, and the payment link while it is still waiting for payment.
Path parameters
string
required
UUID of the order.
Response
Same shape as Create order response.status is one of new, waiting_payment, paid, provisioning_failed, provisioned, cancelled, refunded, expired — see Order statuses.
string
Where to send the customer to pay. Set while
status is waiting_payment for any external payment method (card checkout, crypto, SBP, Telegram Stars), null otherwise.Read this endpoint to follow an unpaid order. If the payment window closes unpaid,
status becomes expired and payment_url is null. A payment that arrives after that may be credited to your account balance, depending on the payment method; the order stays expired. See Payment methods for what happens to a payment that arrives late.You can only retrieve orders that belong to your account. Requesting another user’s order returns
403 Forbidden.Mobile rotating orders return a flat live-snapshot shape, fetched
from the upstream provider on each request. The response carries
"type": "mobile" and a superset of fields: the live state
(signature, tags, current_ip, status) plus durable order
metadata (country, city, isp, period_days, total_usd,
created_at, …).An order that was never provisioned — new, waiting_payment,
expired or cancelled — has no live proxy to read. It returns the
ordinary order record described under Response instead of this
snapshot, with payment_url included.Two fields look similar but mean different things:
status is the live proxy state (e.g. "active") reported by the
provider on this request; order_status is the order lifecycle
value (e.g. "provisioned").The Python SDK dispatches automatically: proxyjam.orders.get() returns
either an Order or a MobileProxy based on the response shape.Example
curl https://api.proxyjam.com/public/v1/orders/order-uuid-here \
-H "X-API-Key: pj_AbCdEf..."
from proxyjam import ProxyJamClient, MobileProxy
with ProxyJamClient(api_key="pj_live_...") as proxyjam:
result = proxyjam.orders.get("order-uuid-here")
if isinstance(result, MobileProxy):
print(result.signature, result.current_ip)
else:
print(result.status, result.proxy_host, result.proxy_port)
{
"id": "order-uuid-here",
"status": "provisioned",
"total_usd": 7.0,
"proxy_type": "residential",
"ip_version": "IPv4",
"protocol": "HTTP",
"country": "US",
"quantity": 2,
"period_days": 30,
"payment_method": "wallet",
"payment_intent_id": null,
"payment_url": null,
"proxy_access": [
{
"id": "1836367",
"host": "proxy.ProxyJam.com",
"port": 10001,
"username": "usr_abc",
"password": "<proxy-password>",
"protocol": "HTTP",
"status": "active",
"expires_at": "2024-02-14T10:00:00Z",
"whitelisted_ips": [],
"bandwidth_total_gb": 1.0,
"bandwidth_used_gb": 0.0
}
]
}
{
"type": "mobile",
"id": "order-uuid-here",
"status": "active",
"auto_renew": true,
"expires_at": "2026-12-31T23:59:59Z",
"host": "gw.proxyjam.com",
"port": 24534,
"username": "pj_abc",
"password": "<proxy-password>",
"current_ip": "203.0.113.10",
"signature": "android",
"tags": ["scrape"],
"whitelisted_ips": [],
"order_status": "provisioned",
"proxy_type": "mobile",
"ip_version": "IPv4",
"protocol": "HTTP",
"country": "US",
"city": null,
"isp": "T-Mobile",
"period_days": 1,
"bandwidth_gb": null,
"quantity": 1,
"total_usd": 1.5,
"total_amount": "1.50",
"currency": "USD",
"promo_code_id": null,
"discount_usd": null,
"created_at": "2026-12-30T23:59:59Z",
"updated_at": "2026-12-31T00:15:01Z",
"payment_intent_id": null,
"previous_expires_at": null
}