---
title: "Renew a domain"
method: POST
path: "/{account}/registrar/domains/{domain}/renewals"
tags: ["registrar renewal"]
---

# Renew a domain

`POST /{account}/registrar/domains/{domain}/renewals`

Explicitly renews a domain, if the registry supports this function.

Your account must be active for this command to complete successfully. You will be automatically charged the renewal fee upon successful renewal, so please be careful with this command.

## Path parameters

- `account` integer, required
- `domain` string, required

## Request body

- object
  - `period` integer, required
  - `premium_price` string — Required as confirmation of the price, only if the domain is premium.

## Response `201`

Domain renewal created

- object
  - `data` DomainRenewal, required
    - `id` integer, required
    - `domain_id` integer, required
    - `period` integer, required
    - `state` 'cancelled' | 'new' | 'renewing' | 'renewed' | 'failed', required
    - `created_at` string, date-time, required — A date-time value, representing when the entry was created, formatted as ISO 8601.
    - `updated_at` string, date-time, required — A date-time value, representing when the entry was last updated, formatted as ISO 8601.

## Other responses

- `400` — A required parameter is missing or the request is invalid.

---

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