> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mogalts.win/llms.txt
> Use this file to discover all available pages before exploring further.

# Errors

> API error handling

All responses use a consistent envelope:

## Response Format

<Tabs>
  <Tab title="Success">
    ```json theme={null}
    {
      "success": true,
      "data": { ... }
    }
    ```
  </Tab>

  <Tab title="Error">
    ```json theme={null}
    {
      "success": false,
      "error": "Human-readable message"
    }
    ```
  </Tab>
</Tabs>

## Status Codes

| 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 |

## Common Errors

<AccordionGroup>
  <Accordion title="Invalid API key">
    Your key is wrong or was regenerated. Get a fresh one from the dashboard.
  </Accordion>

  <Accordion title="Insufficient balance">
    You don't have enough credits. Buy more from the storefront.
  </Accordion>

  <Accordion title="Out of stock">
    The category is empty. Wait for restock or try a different category.
  </Accordion>

  <Accordion title="Invalid category">
    Check spelling. Valid: `Hypixel Unbanned`, `Donut Unbanned`, `Hypixel Banned`
  </Accordion>

  <Accordion title="Rate limit exceeded">
    Slow down. Wait for the `Retry-After` header value.
  </Accordion>
</AccordionGroup>