---
title: "POST /v1/{+registration}:renewDomain"
method: POST
path: "/v1/{+registration}:renewDomain"
tags: ["projects"]
---

# POST /v1/{+registration}:renewDomain

`POST /v1/{+registration}:renewDomain`

Renews a recently expired domain. This method can only be called on domains that expired in the previous 30 days. After the renewal, the new expiration time of the domain is one year after the old expiration time and you are charged a `yearly_price` for the renewal.

## Path parameters

- `registration` string, required

## Request body

- RenewDomainRequest — Request for the `RenewDomain` method.
  - `yearlyPrice` Money — Represents an amount of money with its currency type.
    - `currencyCode` string — The three-letter currency code defined in ISO 4217.
    - `units` string, int64 — The whole units of the amount. For example if `currencyCode` is `"USD"`, then 1 unit is one US dollar.
    - `nanos` integer — Number of nano (10^-9) units of the amount. The value must be between -999,999,999 and +999,999,999 inclusive. If `units` is positive, `nanos` must be positive or zero. If `units` is zero, `nanos` can be positive, zero, or negative. If `units` is negative, `nanos` must be negative or zero. For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
  - `validateOnly` boolean — Optional. When true, only validation is performed, without actually renewing the domain. For more information, see [Request validation](https://cloud.google.com/apis/design/design_patterns#request_validation)

## Response `200`

Successful response

---

[API](https://skmtc.net/google/apis/domains.md) · [All operations](https://skmtc.net/google/apis/domains/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/google/domains/versions/96ed971a98da/schema)
