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

# Renew Order

> Extend the period of an existing order via the Reseller API

This action renews the period of the selected order through the API.

## Method / Endpoint

```text theme={null}
POST {{API_URL}}/order/renewal
```

For Hostrox, the full URL is:

```text theme={null}
POST https://client.hostrox.net/api/reseller/order/renewal
```

## Request parameters

| Name              | Required | Description                                                                      |
| ----------------- | -------- | -------------------------------------------------------------------------------- |
| `key`             | Yes      | API Key                                                                          |
| `id`              | Yes      | Order ID number                                                                  |
| `period_type`     | Yes      | The period to extend by. Possible values: `year`, `month`, `week`, `day`, `hour` |
| `period_duration` | Yes      | Length of the extension period                                                   |

## Example cURL request

```bash theme={null}
curl --location 'https://client.hostrox.net/api/reseller/order/renewal' \
  --header 'Content-Type: application/json' \
  --data '{
    "key": "UzZBSlBWeWk0UEcrVWxlU0RjS1B1dz09",
    "id": 3,
    "period_type": "month",
    "period_duration": 1
  }'
```

## Example JSON response

```json theme={null}
{
  "status": "successful",
  "invoice_id": 5,
  "new_duedate": "2024-03-27 07:37:28",
  "fee": "24.0000",
  "fee_formatted": "$24"
}
```

## Response fields