API

Proxya API

The Proxya API lets programs and AI clients work with the account: read the balance and orders, buy and renew proxies, read credentials and change proxy settings, within the permissions of an API key.

Updated 22 November 2026

What the API does#

  • Reads the balance, orders, prices, stock and residential traffic.
  • Buys new orders and renews existing ones from the balance, within a daily limit set on the key.
  • Returns proxy logins, passwords and links, and generates residential proxies.
  • Changes proxy settings: password, IP whitelist, OS fingerprint, mobile IP rotation.

The same API is available to AI clients through the MCP server.

Base address and format#

Every address in this section is relative to https://proxya.co/api/v1. Requests and responses are JSON. The API key goes in the Authorization header.

http
Authorization: Bearer proxya_...

A key is made in the dashboard under API keys. How keys and permissions work is described on API keys and permissions.

First request#

The key is read from the PROXYA_API_KEY environment variable. The request returns the account and its balance.

curl https://proxya.co/api/v1/users/me \
  -H "Authorization: Bearer $PROXYA_API_KEY"

Errors#

An error answers with an HTTP status and a JSON body with detail. For 422 the detail is a list of fields with the reason for each.

json
{"detail": "This API key doesn't have the purchase permission"}
StatusMeaning
400The request is refused by a rule: daily limit reached, no Idempotency-Key on a purchase, the price differs from the current one.
401No key, or the key is unknown, revoked or expired.
402Not enough balance.
403The key lacks the permission, the endpoint does not accept keys, the address is not on the key's IP list, or the account is suspended.
404The order does not exist or belongs to another account.
409The Idempotency-Key was used for a different request, or the first request with it is still running.
422A field is missing or has a wrong value.
429Too many requests. The Retry-After header gives the seconds to wait.
502, 503A supplier or a service is temporarily unavailable. Before repeating a purchase, check the orders.

Rate limits#

  • 120 requests per minute per key, all endpoints together.
  • 10 purchases, renewals or restores per minute from one address.
  • Some actions have their own limit, for example a new mobile IP 12 times a minute.

In this section#

Didn't find the answer?

Support answers in the chat on this site around the clock. On Telegram the reply usually comes fastest, and a ticket gets an answer by email.