Error Response Format
All API errors return a JSON body with the following shape:
{
"error": "ERROR_CODE",
"message": "A human-readable description."
}Common Error Codes
401 — Unauthorized
Your API key is missing or invalid. Check that you are passing the key in the Authorization: Bearer header and that it has not been revoked.
402 — Insufficient Balance
Your account does not have enough balance to complete the request. Top up your wallet and retry.
404 — Not Found
The requested resource (order, service, country) does not exist. Double-check the ID or slug in your request.
409 — Order Already Active
You already have an active rental for this service. Wait for it to expire or cancel it before starting a new one.
422 — Validation Error
One or more required parameters are missing or invalid. The message field will describe what needs to be corrected.
429 — Too Many Requests
You have exceeded the rate limit. Slow down your requests or contact support to discuss a higher limit.
503 — Service Unavailable
The service or country you requested is temporarily out of stock. Try a different country or check back shortly.