API key is required | 401 | The X-Api-Key header is missing. | Add the header to every request. |
Invalid API key | 401 | The key is wrong, was rotated, or API access is not enabled. | Check the key in the dashboard. |
IP address not allowed | 403 | The request IP is not on your allow-list. | Add the IP, or remove the restriction. |
Insufficient balance | 403 | Your available balance is lower than the order total. | Add funds, then retry. |
Insufficient allocated stock. Only N unit(s) remaining… | 422 | Your stock allocation is smaller than the quantity. Nothing was charged. | Buy fewer units or ask for a larger allocation. |
Your allocated stock for this product is not currently available. | 422 | Your allocation is paused or expired. | Contact support. |
Order not found | 404 | The order does not exist or is not yours. | Check the ID. |
Product not found | 404 | The product or variant does not exist. | Refresh your catalog. |
Product out of stock | 400 | A key-based variant has no units left. | Choose another variant or wait. |
Validation failed | 400 | Invalid input. | See the field errors below. |
Too Many Requests | 429 | Rate limit exceeded. | Back off (see below). |
Upstream service unavailable | 502 | The platform is temporarily unreachable. | Retry reads after a few seconds. |