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.
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.
{"detail": "This API key doesn't have the purchase permission"}| Status | Meaning |
|---|---|
| 400 | The request is refused by a rule: daily limit reached, no Idempotency-Key on a purchase, the price differs from the current one. |
| 401 | No key, or the key is unknown, revoked or expired. |
| 402 | Not enough balance. |
| 403 | The 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. |
| 404 | The order does not exist or belongs to another account. |
| 409 | The Idempotency-Key was used for a different request, or the first request with it is still running. |
| 422 | A field is missing or has a wrong value. |
| 429 | Too many requests. The Retry-After header gives the seconds to wait. |
| 502, 503 | A 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.