OpenAPI Documentation
OpenAPI Documentation

Integration overview

The Open API provides wallet balance queries, dynamic proxy management, and static proxy management. It is designed for requests made by your server-side application.

API capabilities

Capability Description
Wallet Query the USD balance available for purchases
Dynamic traffic List products, purchase traffic, and query balances, daily usage, batches, and orders
Dynamic regions Query available region codes by country, province/state, and city
Dynamic sub-accounts Create and query sub-accounts, set traffic limits, enable or disable accounts, and generate connection credentials
Static proxies Query regions, inventory, and quotes; purchase proxies, query resources, and renew them
Callback notifications Send one notification when a static proxy purchase or renewal order reaches a terminal state

API keys are created, renamed, enabled, disabled, and revoked through the web console. These operations are outside the scope of the business APIs in this documentation.

Service endpoints

Environment Base URL Purpose
Test https://api-test.puraroute.com/gin Development and integration testing
Production https://api.puraroute.com/gin Production business requests

Append the request path from each API article to the Base URL. For example:

https://api-test.puraroute.com/gin/open-api/v1/wallet/balance
  1. Create an API key for the test environment in the web console.
  2. Follow the Quickstart to verify authentication and network connectivity.
  3. Choose either the dynamic proxy or static proxy workflow based on your business needs.
  4. Implement error-code handling, timeouts, duplicate-submission protection, and sensitive-data protection.
  5. Go live with a production API key and the production Base URL.

Data security

API keys, proxy account names, proxy passwords, and complete connection credentials are sensitive. Do not place them in browser code, public logs, error pages, monitoring labels, or support ticket bodies.

On this page