---
title: "Renew the specified Domain"
method: POST
path: "/v1/domains/{domain}/renew"
tags: ["v1"]
---

# Renew the specified Domain

`POST /v1/domains/{domain}/renew`

## Path parameters

- `domain` string, required

## Headers

- `X-Shopper-Id` string

## Request body

- DomainRenew
  - `period` integer — Number of years to extend the Domain. Must not exceed maximum for TLD. When omitted, defaults to `period` specified during original purchase

## Response `200`

Request was successful

- DomainPurchaseResponse
  - `currency` string, iso-currency-code — Currency in which the `total` is listed
  - `itemCount` integer, required — Number items included in the order
  - `orderId` integer, required — Unique identifier of the order processed to purchase the domain
  - `total` integer, required — Total cost of the domain and any selected add-ons

## Other responses

- `400` — Request was malformed
- `401` — Authentication info not sent or invalid
- `403` — Authenticated user is not allowed access
- `404` — Resource not found
- `409` — The domain status does not allow performing the operation
- `422` — End-user must read and consent to all of the following legal agreements<br>`domain` must match `sld.tld`
- `429` — Too many requests received within interval
- `500` — Internal server error

---

[API](https://skmtc.net/godaddy/apis/domains-api.md) · [All operations](https://skmtc.net/godaddy/apis/domains-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/godaddy/domains-api/revisions/475bd0561c3c/schema)