Proxy History

Get a list of your ordered proxies and manage their settings.

Get Proxy History

Retrieve all proxies you have ordered.

Endpoint

GET /proxies/history/

Query Parameters

Parameter	Type	Required	Description
page	integer	No	Page number for pagination
page_size	integer	No	Number of results per page

Request

curl -X 'GET' \
  'https://app.cyberyozh.com/api/v1/proxies/history/' \
  -H 'accept: application/json' \
  -H 'X-Api-Key: your_api_key_here'

Response

{
  "count": 1,
  "next": null,
  "previous": null,
  "results": [
    {
      "id": "9a440c2a-157f-4562-8209-25022ec4143a",
      "url": "socks5://0.0.0.0:10000",
      "connection_login": "connection_login",
      "connection_password": "connection_password",
      "system_status": "active",
      "expired": false,
      "access_starts_at": "2023-08-25T11:25:31.218478Z",
      "access_expires_at": "2023-08-26T11:25:28.742274Z",
      "public_ipaddress": "1.1.1.1",
      "geoip": "United States",
      "traffic_remains": -1,
      "change_ip_links": [],
      "ovpn_config_link": "---",
      "auto_renew_request": false,
      "proxy_category": "lte",
      "access_type": "private",
      "connection_host": "0.0.0.0",
      "connection_port": "10000",
      "xray_settings_str": null
    }
  ]
}

Response Fields

Field	Type	Description
count	integer	Total number of results
next	string	URL of the next page (null if last)
previous	string	URL of the previous page (null if first)
results	array	Array of proxy history records
id	string (UUID)	Unique proxy identifier
url	string	Proxy connection URL
connection_login	string	Login credentials
connection_password	string	Password credentials
connection_host	string	Proxy server hostname
connection_port	string	Proxy server port
system_status	string	Current status (active, inactive)
expired	boolean	Whether proxy has expired
access_starts_at	string (datetime)	Start time of access
access_expires_at	string (datetime)	Expiration time
public_ipaddress	string	Public IP address
geoip	string	Geographic location
traffic_remains	integer	Remaining traffic in bytes (-1 for unlimited)
change_ip_links	array	Links to change IP
ovpn_config_link	string	OpenVPN configuration link
auto_renew_request	boolean	Auto-renewal status
proxy_category	string	Category: datacenter, lte, residential_rotating, residential_static
access_type	string	Access type: shared or private
xray_settings_str	string	Xray proxy settings (null if not applicable)

Update Auto-Renewal

Change the auto-renewal setting for a proxy.

Endpoint

PATCH /proxies/history/{id}/

Path Parameters

Parameter	Type	Required	Description
id	string (UUID)	Yes	Proxy history record identifier

Request

curl -X 'PATCH' \
  'https://app.cyberyozh.com/api/v1/proxies/history/9a440c2a-157f-4562-8209-25022ec4143a/' \
  -H 'accept: application/json' \
  -H 'X-Api-Key: your_api_key_here' \
  -H 'Content-Type: application/json' \
  -d '{
    "auto_renew_request": true
  }'

Request Body

Field	Type	Required	Description
auto_renew_request	boolean	No	Enable or disable auto-renewal

Response

Returns the full proxy history object (see response fields above).

Change Fingerprint

Modify browser fingerprint for a designated proxy server.

Endpoint

POST /proxies/history/{id}/change-fingerprint/

Path Parameters

Parameter	Type	Required	Description
id	string (UUID)	Yes	Proxy history record identifier

Request

curl -X 'POST' \
  'https://app.cyberyozh.com/api/v1/proxies/history/9a440c2a-157f-4562-8209-25022ec4143a/change-fingerprint/' \
  -H 'accept: application/json' \
  -H 'X-Api-Key: your_api_key_here' \
  -H 'Content-Type: application/json' \
  -d '{
    "value": "windows:4"
  }'

Request Body

Field	Type	Required	Description
value	string	Yes	Fingerprint identifier (see values below)

Fingerprint Values

Value	Description
android:4	Android 14
macosx:4	MacOSX 12.6
ios:3	iPhone 12 Max
windows:1	Windows 10 Server
windows:4	Windows 10 Desktop
""	Reset fingerprint

Response

{
  "status": "success",
  "message": "Fingerprint updated successfully",
  "code": "FINGERPRINT_UPDATED"
}