Skip to main content
GET
Get Order
Retrieve detailed proxy information for a specific order, including all assigned IP addresses.

Request

Headers

Path Parameters

string
required
The order ID returned from order creation.

Query Parameters

string
Proxy output format. Options:
  • ipup - ip:port:username:password (default)
  • upip - username:password:ip:port
  • upaip - username:password@ip:port
  • object - JSON object format
string
http (default) or socks5. With socks5, each proxy comes back with the SOCKS5 port in place of the HTTP port. The IPs, username and password stay the same. Leave it off and you get the same HTTP list as before. Any other value returns 400.
string
windows, macos, ios or linux. Adds -os-<value> to each username in proxies to choose that TCP/IP fingerprint. The password, IP and port stay the same, and so does the top-level proxy_username. Leave it off for the default list. Any other value, including android, returns 400.

Example Requests

Default Format

Custom Format

SOCKS5 List

protocol works with every format, so ?format=object&protocol=socks5 returns SOCKS5 proxies as JSON objects.

Response

Success Response

Success Response (Object Format)

Response Fields

string
Status of the request.
object
Order details object.
string
Unique order identifier.
string
Stripe subscription ID.
string
Product type identifier.
integer
Number of proxies in the order.
integer
Purchase timestamp (Unix epoch).
integer
Expiration timestamp (Unix epoch).
string
Authentication username for all proxies in this order.
string
Authentication password for all proxies in this order.
array
Array of proxy strings or objects (depending on format).

Error Responses

400 Bad Request - Invalid Protocol

400 Bad Request - Invalid Fingerprint

404 Not Found

500 Internal Server Error

Notes

  • Pass the order_id. The lookup is not case-sensitive
  • All proxies in an order share the same username and password
  • Use the port shown in your proxy list
  • If your proxies are still being assigned, proxies can be empty or short. Fetch again after a moment
  • Every proxy in an order also works over SOCKS5 with the same IP, username and password. Add ?protocol=socks5 to get that list, and read the port from the response rather than hard-coding it
  • To choose a Windows, macOS, iOS or Linux TCP/IP fingerprint, add ?fingerprint=macos (or windows, ios, linux). See TCP Fingerprint Profiles