Errors

All responses use a consistent envelope:

Response Format

{
  "success": true,
  "data": { ... }
}

{
  "success": false,
  "error": "Human-readable message"
}

Status	Meaning
`200`	Success
`400`	Bad request — check your parameters
`401`	Missing or invalid API key
`429`	Rate limit exceeded
`503`	Store temporarily offline — try again shortly

Invalid API key

Your key is wrong or was regenerated. Get a fresh one from the dashboard.

Insufficient balance

You don’t have enough credits. Buy more from the storefront.

Out of stock

The category is empty. Wait for restock or try a different category.

Invalid category

Check spelling. Valid: Hypixel Unbanned, Donut Unbanned, Hypixel Banned

Rate limit exceeded

Slow down. Wait for the Retry-After header value.