Customer
Proxy
Proxy User
Residential Ledger
Service Adjustment
Checkout
Analytics
Product
Subdivision
Retrieve Service
Retrieves a specific Service based on the provided ID for the current user’s account. If the ‘show_proxies’ parameter is set to ‘True’, it will also fetch proxies associated with each service and add them to the result.
curl --request GET \
--url https://api.pingproxies.com/1.0/public/user/service/retrieve/{service_id} \
--header 'X-API-Private-Key: <api-key>' \
--header 'X-API-Public-Key: <api-key>'
{
"data": {
"country_id": "us",
"payment_method_id": "pm_1NjyqfB2BUlqim5l2LgRUo0a",
"service_creation_datetime": "2023-09-12 10:00:00",
"service_cycle": "1:month",
"service_dispatch_datetime": "2023-09-12 11:00:00",
"service_earliest_cancellation_datetime": "2023-09-12 12:00:00",
"service_expiry_datetime": "2023-10-12 10:00:00",
"service_id": "API-1234-5678",
"service_image": "https://apple.com/image.png",
"service_is_automatic_collection": true,
"service_is_pending_cancellation": false,
"service_last_update_datetime": "2023-09-12 12:00:00",
"service_metadata": {
"resell_customer_id": "APPL-9876-5432"
},
"service_name": "Premium ISP",
"service_promotional_code": "PROMO2023",
"service_protocol": "ipv4",
"service_quantity": 5,
"service_status": "active",
"service_subscription_id": "sub_1NpPVfB2BUlqim5lA374YoIh",
"service_subscription_is_paused": false,
"service_total": 100,
"service_type": "isp"
},
"message": "Service successfully retrieved."
}
Authorizations
Private API key for user-level authentication.
Public API key for user-level authentication.
Path Parameters
ID of the Service to retrieve
Query Parameters
If the proxies associated with the service should be returned
Response
Service retrieve was successful.
Retrieved Service item details.
"us"
"pm_1NjyqfB2BUlqim5l2LgRUo0a"
"1:month"
"API-1234-5678"
"https://apple.com/image.png"
true
false
{ "resell_customer_id": "APPL-9876-5432" }
"Premium ISP"
"PROMO2023"
ipv4
, ipv6
, dual
"ipv4"
5
awaiting_manual_fulfillment
, awaiting_additional_fulfillment
, awaiting_fulfillment
, active
, canceled
, complete
, paused
, overdue
"active"
"sub_1NpPVfB2BUlqim5lA374YoIh"
false
100
datacenter
, isp
, residential
, off_catalog
"isp"
"107.225.73.142"
"2600:1000:b12a:6351:8523:997e:93c4:f124"
8080
"7a018d34-76c2-4c23-b14d-f7b9a7054e25"
"DHf3PSQXQ7rw1v9"
ipv4
, ipv6
, dual
"ipv4"
1080
available
, in_use
, reserved
, waiting
, pending_deletion
"in_use"
datacenter
, isp
, residential
"isp"
"att7018user"
"API-1234-5678"
Status message for the retrieval.
curl --request GET \
--url https://api.pingproxies.com/1.0/public/user/service/retrieve/{service_id} \
--header 'X-API-Private-Key: <api-key>' \
--header 'X-API-Public-Key: <api-key>'
{
"data": {
"country_id": "us",
"payment_method_id": "pm_1NjyqfB2BUlqim5l2LgRUo0a",
"service_creation_datetime": "2023-09-12 10:00:00",
"service_cycle": "1:month",
"service_dispatch_datetime": "2023-09-12 11:00:00",
"service_earliest_cancellation_datetime": "2023-09-12 12:00:00",
"service_expiry_datetime": "2023-10-12 10:00:00",
"service_id": "API-1234-5678",
"service_image": "https://apple.com/image.png",
"service_is_automatic_collection": true,
"service_is_pending_cancellation": false,
"service_last_update_datetime": "2023-09-12 12:00:00",
"service_metadata": {
"resell_customer_id": "APPL-9876-5432"
},
"service_name": "Premium ISP",
"service_promotional_code": "PROMO2023",
"service_protocol": "ipv4",
"service_quantity": 5,
"service_status": "active",
"service_subscription_id": "sub_1NpPVfB2BUlqim5lA374YoIh",
"service_subscription_is_paused": false,
"service_total": 100,
"service_type": "isp"
},
"message": "Service successfully retrieved."
}