GET
API Status
Check service availability and server time. No API key is required.
/api/v1/developer/status
Example response
{
"status": "operational",
"version": "1.0.0",
"serverTime": "2026-08-27T12:00:00.000Z"
}🔌 SP5 Developer Portal
Test live endpoints, inspect responses, and ship your integration faster.
Building a reseller business? Read the SP5 Reseller API documentation
Interactive API console
Send a live, read-only request to an allowlisted SP5 endpoint and inspect the full response.
Same-origin · no secret storage
GET
/api/v1/developer/statusVerify that the public API is online and inspect server time.
This endpoint is public and does not require a key.
Security boundary: the console supports only the four fixed GET routes shown above. Custom URLs, custom methods, request bodies, and redirects are intentionally disabled.
Choose an endpoint and send a request.
Status, timing, headers, and body will appear here.
import requests
response = requests.get(
"https://sp5proxies.com/api/v1/developer/status",
timeout=30,
)
response.raise_for_status()
print(response.headers)
print(response.json())Endpoint reference
Send X-API-Key: YOUR_API_KEY on authenticated routes. The API is mounted at both /api/v1 and /api/developer — every path below works with either prefix.
GET
Account Overview
Retrieve account metadata, balance, referral code, and proxy count.
/api/v1/developer/account
GET
Account Balance
Read the current account balance and billing currency.
/api/v1/developer/balance
Example response
{
"balance": 42.5,
"currency": "USD"
}GET
List Your Proxies
Retrieve proxies owned by the API-key account.
/api/v1/developer/proxies
Example response
{
"count": 1,
"proxies": [
{
"id": "uuid",
"ip": "1.2.3.4",
"port": 20001,
"type": "SOCKS5",
"country": "United States",
"city": "Sacramento",
"status": "ACTIVE",
"expiresAt": "2026-12-31T23:59:59Z"
}
]
}DELETE
Delete a Proxy
Soft-delete a proxy owned by the API-key account. The proxy is hidden from your list and marked as deleted by user. Requires the X-API-Key header.
/api/v1/developer/proxies/{id}
Example response
{
"message": "Proxy deleted successfully"
}Real-time webhooks
API and reseller users can subscribe a public HTTPS endpoint to signed lifecycle notifications. Supported events are proxy.rotated, proxy.expiring, and balance.low.
Signing secrets are shown only at creation or rotation. Store them in your server-side secrets manager.
⚡ Rate limits
- • Rate-limit headers are returned with each request.
- • HTTP 429 indicates the current request window has been exceeded.
- • Use bounded retries with exponential backoff and jitter.
Error codes
| Code | Description |
|---|---|
| 400 | Bad Request — invalid parameters |
| 401 | Unauthorized — missing or invalid API key |
| 404 | Not Found — the requested resource does not exist |
| 429 | Too Many Requests — rate limit exceeded |
| 500 | Internal Server Error |