The Customer object represents an account holder in the Ping Proxies system. It contains essential information about a user including their contact details, billing information, and account settings.

​
Key Attributes

AttributeTypeDescription
customer_idintegerUnique identifier for the customer
customer_email_addressstringPrimary email address for the account
customer_first_namestringCustomer’s first name
customer_last_namestringCustomer’s last name
credit_balanceintegerAvailable credit balance in cents
customer_proxy_user_limitintegerMaximum number of proxy users allowed
proxy_countintegerTotal number of proxies associated with the account
residential_bytes_leftintegerRemaining residential bandwidth in bytes
active_residential_service_idstringID of the active residential service

​
Object Relationships

The Customer object is a parent to several other objects in the Ping Proxies API:

  • Proxy Users: Authentication entities created by the customer
  • Services: Subscriptions to proxy products
  • Proxies: Individual proxies allocated to the customer’s services
  • Residential Ledger: Records of residential bandwidth usage
EndpointDescription
GET /public/user/customer/retrieveRetrieve the authenticated customer’s profile

​
Example Response

{
  "data": {
    "customer_id": 1955,
    "customer_email_address": "steve.jobs@apple.com",
    "customer_first_name": "Steve",
    "customer_last_name": "Jobs",
    "credit_balance": 1245,
    "customer_proxy_user_limit": 5,
    "proxy_count": 100,
    "residential_bytes_left": 10737418240,
    "active_residential_service_id": "1955-8012-871"
  },
  "message": "Customer successfully retrieved."
}

​
Usage Notes

  • The credit_balance is displayed in cents (e.g., 1245 means $12.45)
  • When purchasing via API, services must be paid with account credit
  • The residential_bytes_left shows remaining bandwidth for residential proxies
  • The customer_proxy_user_limit determines how many proxy users you can create

​
Best Practices

  • Regularly check your credit_balance before making API purchases
  • Monitor your residential_bytes_left to avoid service interruptions
  • Use the customer_id to reference your account in support requests