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_bodyOrders
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_bodyReturns full details for a single order, including proxy credentials if the order is active.
Path parameters
string
required
UUID of the order.
Response
Same shape as Create order response.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, …).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": "active",
"total_usd": 7.0,
"proxy_type": "residential",
"ip_version": "IPv4",
"protocol": "HTTP",
"country": "US",
"quantity": 2,
"period_days": 30,
"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
}