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

# Renew the specified Domain

`POST /v2/customers/{customerId}/domains/{domain}/renew`

## Request

- Base URL: `https://api.ote-godaddy.com`
- URL: `https://api.ote-godaddy.com/v2/customers/{customerId}/domains/{domain}/renew`
- Auth: none declared

## Path parameters

- `customerId` string, required
- `domain` string, required

## Headers

- `X-Request-Id` string

## Request body

- DomainRenewV2
  - `expires` string, iso-datetime, required: Current date when this domain will expire
  - `consent` ConsentRenew, required
    - `price` integer, required: Price of the domain excluding taxes or fees. Please use GET /v2/customers/{customerId}/domains/{domain} to retrieve the renewal price and currency for the domain
    - `currency` string, iso-currency-code, required: Currency in which the `price` is listed
    - `registryPremiumPricing` boolean: Only required for hosted registrar if domain is premium. If true indicates that the `price` and `currency` listed are the registry premium price and currency for the domain
    - `agreedBy` string, required: Originating client IP address of the end-user's computer when they consented to these legal agreements
    - `agreedAt` string, iso-datetime, required: Timestamp indicating when the end-user consented to these legal agreements
  - `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 `202`

Request Accepted. You may use GET /v2/customers/{customerId}/domains/{domain}/actions/RENEW to poll status

## Other responses

- `400`: Request was malformed
- `401`: Authentication info not sent or invalid
- `403`: Authenticated user is not allowed access
- `404`: The domain does not exist
- `409`: There is already a similar action processing
- `422`: Request body doesn't fulfill schema, see details in `fields`
- `429`: Too many requests received within interval
- `500`: Internal server error

---

[API](https://skmtc.dev/godaddy/apis/domains-api.md) - [All operations](https://skmtc.dev/godaddy/apis/domains-api/llms.txt) - [OpenAPI document](https://skmtc.dev/godaddy/apis/domains-api/revisions/475bd0561c3c?raw)