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

# POST /v1/replace/:orderId

> Request a replacement

Submit a replacement request for an order within the **1-hour replacement window**. An admin reviews and approves/rejects the request — credits are not issued automatically.

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

<ParamField path="orderId" type="string" required>
  The order ID from your history, e.g. `WEB-000042`
</ParamField>

<ParamField body="reason" type="string">
  Optional description of why you need a replacement
</ParamField>

## Request

```json theme={null}
{
  "reason": "Account was already banned when I received it."
}
```

## Response

```json theme={null}
{
  "success": true,
  "data": {
    "pending": true,
    "message": "Replacement request submitted. An admin will review it and process the refund."
  }
}
```

## Example

<CodeGroup>
  ```bash cURL theme={null}
  curl -X POST https://mogalts.win/v1/replace/WEB-000042 \
    -H "X-API-Key: mog_your_key_here" \
    -H "Content-Type: application/json" \
    -d '{"reason":"Account was banned on Hypixel"}'
  ```

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

  response = requests.post(
      "https://mogalts.win/v1/replace/WEB-000042",
      headers={"X-API-Key": "mog_your_key_here"},
      json={"reason": "Account was banned on Hypixel"}
  )
  print(response.json())
  ```
</CodeGroup>