Base URL
https://api.ninjasproxy.devAuth
Authorization: Bearer <token>Format
application/json🔐
Auth
3 endpoints — click an endpoint to expand its details and code examples.
Error Codes
All error responses share this shape:
{
"error": "insufficient_balance",
"message": "Your balance is $0.00. Top up at portal.ninjasproxy.com/billing.",
"request_id": "req_01HX9ZQMABCDEFGH"
}| Status | Code | Meaning |
|---|---|---|
| 400 | bad_request | Malformed body or invalid query params |
| 401 | unauthorized | Missing or invalid Bearer token / API key |
| 402 | insufficient_balance | Balance too low to complete the operation |
| 403 | forbidden | Authenticated but not authorised for this resource |
| 404 | not_found | Resource does not exist |
| 409 | conflict | Concurrent modification — retry with backoff |
| 422 | validation_error | Schema valid but business-logic validation failed |
| 429 | rate_limited | Too many requests — back off and retry |
| 500 | internal_error | Unexpected server error — contact support if persistent |