API reference

The Proxynet API lets you read your organization's proxy services from your own system, place new orders and manage existing services. All requests and responses are JSON; authentication uses a Bearer token.

Base URL

https://api.proxynet.io/api/v1

Use this address for all server-to-server calls. The panel address (app.proxynet.io) is behind Cloudflare and may apply a browser check to requests from some server IPs; api.proxynet.io serves only the API and runs no such check. The token and the paths are the same on both.

Authentication

Add the Authorization header to every request. Cookies are not accepted, and the token cannot be sent in the URL.

curl -H "Authorization: Bearer pxn_live_…" \
  https://api.proxynet.io/api/v1/me

For creating tokens and choosing scopes, see the Authentication and Tokens and scopes pages.

Response format

Successful responses return the data under data; lists carry pagination info under meta.

{
  "data": [ … ],
  "meta": { "total": 6, "limit": 25, "offset": 0, "has_more": false }
}

Errors come back in the same envelope on every endpoint; branch on the code field, not on the message text. The full list of codes is on the Errors page.

Endpoints

The endpoints follow the life cycle of an order: first check the catalog for what you can buy, then place an order, then track the new service fromits product's pages.

Organization

• GET/meToken and organization info · Returns whether the token is valid, its scopes, its organization, the plan, the balance and the rate limit.

Catalog and pricing

• GET/catalogCatalog · Returns everything you can buy, with prices for your plan, in one response.
• GET/locationsLocations · Returns the locations you can choose and their live stock.
• GET/target-urlsTarget domains · Returns the domains you can choose in targeted mode.
• GET/stockStock check · Runs the same stock check that runs when you create an order.
• GET/pricingPrice quote · Calculates the amount you will be charged for a type, quantity and add-ons.

Orders

• GET/ordersList orders · Lists the organization's proxy services; all five types come back together.
• POST/ordersCreate order · Opens the same order you would place in the panel and charges your balance.
• GET/orders/{id}Order details · Returns a single service's state, days left and usage counters.

Endpoints by product

The paths are the same across products (/orders/…); the product pages narrow the body and the examples to that product's fields. To switch to the same operation on another product, use the left menu.

On per-IP products you choose a location and quantity, and the service renews in 30-day periods; per-GB products have a single gateway address, country/city targeting is done with the Endpoint builder, and usage is charged per GB from your balance.