API Reference

REST API for managing your NinjaProxy account.

Base URL: https://api.ninjasproxy.dev
Auth: Authorization: Bearer <token>
Format: application/json

Reference files

🔐 Auth

3 endpoints — click an endpoint to expand request and response examples.

Error Codes

All error responses share this shape:

{
  "error":      "insufficient_balance",
  "message":    "Your balance is $0.00. Top up at portal.ninjasproxy.dev/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