LIVE NETWORK

API REFERENCE

Connect your system to Proxiat and manage your services from one API

API Reference

Introduction

Use the Proxiat API to browse services, place orders, and manage them from your own system.

Base URL: https://api.proxiat.com/api/v1

Create your API token and add webhook url from the API button in the Proxiat Telegram bot. The token is shown once.

Do not add a trailing slash to paths. /proxies/services/rotate-mobile-proxy/ is not valid.

Authentication

Every request must include your token as a Bearer header.

Authorization string required

Format: Bearer pxt_.... An invalid token returns 401. A revoked token returns 403.

Usage limits

Limits are applied per API token, per minute.

Group	Limit	Used by
`read`	120 / minute	GET endpoints
`write`	30 / minute	POST management endpoints
`buy`	10 / minute	POST purchase endpoints
`default`	60 / minute	Fallback

Errors

Errors use a consistent JSON body. Validation failures on /api/v1 are returned as 400, not 422.

Status	error	When
400	`invalid_request`	Missing or invalid field
400	`insufficient_balance`	Not enough balance
400	`unsupported_operation`	Operation is not available for this service
401	`invalid_token`	Token is missing or unknown
403	`token_inactive`	Token is revoked or inactive
404	`order_not_found` / `service_not_found` / `proxy_not_found`	Resource does not exist
409	`proxy_already_bought` / `port_unavailable` / `username_taken`	Conflict
429	`rate_limited`	Too many requests
502	`purchase_failed` / `operation_failed`	Upstream failure

Webhooks

If a webhook is active for proxy.expired, expiry is delivered to your URL instead of Telegram. If delivery fails, Proxiat falls back to Telegram.

Create the webhook in the bot. The signing secret is shown once and starts with whsec_.

X-Proxiat-Timestampstringrequired

Unix timestamp used in the signature. Reject the request if it is older than 2 minutes.

X-Proxiat-Signaturestringrequired

sha256=<hex> of HMAC-SHA256(secret, "{timestamp}.{raw_body}").

Sign the raw request body as received. Do not rebuild or pretty-print the JSON before verifying.

Respond with 2xx within 5 seconds. Otherwise Proxiat falls back to Telegram.

The body is id, type, created_at, and data. For expiry, data.order_id is the expired order.

Get account

Return the user id, token status, and current balance.

GET/api/v1/me

List services

Return public catalog keys and plan prices. final_price is the amount that will be charged.

GET/api/v1/proxies/services

Get stock

Return the options available to purchase for a service. Take the service key from GET /proxies/services.

GET/api/v1/proxies/services/{service_key}

service_keystringrequired

Path parameter. A catalog key from List services.

countrystringoptional

Filter by country name or code.

statestringoptional

Filter by state.

ispstringoptional

Filter by ISP.

Buy Ultra SOCKS

Purchase one Ultra SOCKS proxy from stock. Send an empty body.

POST/api/v1/proxies/services/ultra-socks/{proxy_id}

proxy_idintegerrequired

Listing id from stock.

Buy rotate mobile proxy

Create a rotate mobile proxy. Location comes from stock. Do not send country or ISP.

POST/api/v1/proxies/services/rotate-mobile-proxy

server_namestringrequired

Server name from stock.

portintegerrequired

Port from that server.

protocolstringrequired

http or socks5.

duration_hoursintegerrequired

A duration allowed on this port.

auth_methodstringrequired

user_pass or ip.

usernamestringoptional

Required when auth_method is user_pass.

passwordstringoptional

Required when auth_method is user_pass.

auth_ipstringoptional

Required when auth_method is ip.

List proxies

Return proxies you already own. Owned operations below work only for rotate-mobile-proxy.

GET/api/v1/proxies

service_keystringoptional

Filter by a service key from the catalog.

order_idstringoptional

Return one owned order.

limitintegeroptional

1–200. Default 200.

Extend

Add time to an active rotate mobile proxy.

POST/api/v1/proxies/{order_id}/extend

order_idstringrequired

Owned rotate order id.

duration_hoursintegerrequired

Hours to add. Must be an allowed plan for this port.

Renew

Renew an expired rotate mobile proxy. Returns a new order_id.

POST/api/v1/proxies/{order_id}/renew

order_idstringrequired

Expired rotate order id.

duration_hoursintegerrequired

Plan duration for the new order.

Change location

Move an active rotate mobile proxy to another server and port.

POST/api/v1/proxies/{order_id}/location

server_namestringrequired

Target server from stock.

portintegerrequired

Target port on that server.

Change protocol

Switch an active rotate mobile proxy between HTTP and SOCKS5.

POST/api/v1/proxies/{order_id}/protocol

protocolstringrequired

http or socks5.

Change auth

Update username, password, or auth IP. Send only the fields you want to change.

POST/api/v1/proxies/{order_id}/auth

usernamestringoptional

New username.

passwordstringoptional

New password.

auth_ipstringoptional

New authentication IP.

Change auth method

Switch an active rotate mobile proxy between user/password and IP authentication.

POST/api/v1/proxies/{order_id}/auth-method

auth_methodstringrequired

user_pass or ip.

usernamestringoptional

Required when switching to user_pass.

passwordstringoptional

Required when switching to user_pass.

auth_ipstringoptional

Required when switching to ip.