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

# GET /v1/orders

> List your order history

Returns your order history, newest first. Supports pagination.

<ParamField header="X-API-Key" type="string" required>
  Your API key
</ParamField>

<ParamField query="page" type="integer" default="1">
  Page number, starting at 1
</ParamField>

<ParamField query="limit" type="integer" default="20">
  Orders per page. Max: 50
</ParamField>

## Response

```json theme={null}
{
  "success": true,
  "data": {
    "orders": [
      {
        "id": "WEB-000042",
        "type": "purchase",
        "category": "Hypixel Unbanned",
        "amount": 2,
        "cost": 20,
        "status": "completed",
        "timestamp": 1713916800000,
        "created_at": "2025-04-23T16:00:00",
        "source": "api"
      }
    ],
    "total": 37,
    "page": 1,
    "limit": 20
  }
}
```

## Example

<CodeGroup>
  ```bash cURL theme={null}
  curl "https://mogalts.win/v1/orders?page=1&limit=10" \
    -H "X-API-Key: mog_your_key_here"
  ```

  ```python Python theme={null}
  import requests

  response = requests.get(
      "https://mogalts.win/v1/orders",
      headers={"X-API-Key": "mog_your_key_here"},
      params={"page": 1, "limit": 10}
  )
  data = response.json()["data"]
  print(f"{data['total']} total orders")
  ```

  ```javascript JavaScript theme={null}
  const res = await fetch("https://mogalts.win/v1/orders?page=1&limit=10", {
    headers: { "X-API-Key": "mog_your_key_here" }
  });
  const { data } = await res.json();
  console.log(`${data.total} total orders`);
  ```
</CodeGroup>