Understanding the Proxy object and its role in the Ping Proxies API
Attribute | Type | Description |
---|---|---|
proxy_id | string | Unique identifier for the proxy (UUID format) |
proxy_ip_address | string | Main IPv4 address of the proxy |
proxy_protocol | string | IP protocol of the proxy (ipv4, ipv6, dual) |
proxy_type | string | Type of proxy (datacenter, isp, residential) |
proxy_http_port | integer | HTTP port number for the proxy |
proxy_socks5_port | integer | SOCKS5 port number for the proxy |
proxy_status | string | Current status of the proxy (available, in_use, reserved, etc.) |
proxy_username | string | Proxy-specific authentication username (if configured) |
proxy_password | string | Proxy-specific authentication password (if configured) |
service_id | string | ID of the service this proxy is associated with |
country_id | string | ISO country code where the proxy is located |
asn_id | integer | Autonomous System Number (network provider) |
city_id | integer | ID of the city where the proxy is located |
subdivision_id | string | ID of the region/state where the proxy is located |
Attribute | Type | Description |
---|---|---|
ip_address_id_v4 | string | IPv4 address identifier |
ip_address_id_v6 | string | IPv6 address identifier (for dual or ipv6 proxies) |
subnet_id | string | IPv4 subnet the proxy belongs to |
subnet_id_v6 | string | IPv6 subnet the proxy belongs to (for dual or ipv6 proxies) |
asn_name | string | Name of the Autonomous System (e.g., “AT&T Services, Inc.”) |
Attribute | Type | Description |
---|---|---|
country_name | string | Full name of the country (e.g., “United States”) |
subdivision_name | string | Full name of the region/state (e.g., “California”) |
city_name | string | Full name of the city (e.g., “Los Angeles”) |
city_latitude | number | Latitude coordinates of the city |
city_longitude | number | Longitude coordinates of the city |
city_timezone | string | Timezone of the city (e.g., “America/Los_Angeles”) |
Status | Description |
---|---|
available | Proxy is ready but not actively assigned |
in_use | Proxy is actively assigned to a service and available for use |
reserved | Proxy is reserved for future use |
waiting | Proxy is being provisioned or prepared |
pending_deletion | Proxy is scheduled for removal |
Endpoint | Description |
---|---|
GET /public/user/proxy/retrieve/{proxy_id} | Retrieve a specific proxy |
GET /public/user/proxy/search | Search proxies with filters |
GET /public/user/proxy/list_by_search | Retrieve formatted proxy lists |
POST /public/user/proxy/list_by_id | Generate formatted proxy lists by ID |
PATCH /public/user/proxy/edit/{proxy_id} | Edit a proxy |
proxy_ip_address
or ip_address_id_v4
(they contain the same value if you’ve purchased IPv4 proxies)ip_address_id_v6
http_formatted
: Formatted HTTP proxy stringsocks5_formatted
: Formatted SOCKS5 proxy string