---
title: "Restore a domain"
method: POST
path: "/{account}/registrar/domains/{domain}/restores"
tags: ["registrar restore"]
---

# Restore a domain

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

## Request

- Base URL: `https://api.dnsimple.com/v2`
- URL: `https://api.dnsimple.com/v2/{account}/registrar/domains/{domain}/restores`
- Auth: one of:
  - HTTP basic
  - HTTP bearer
- TypeScript: <https://skmtc.dev/dnsimple/apis/dnsimple-api/docs/:account/registrar/domains/:domain/restores/post.ts> (a function with typed inputs; its response is checked against the schema)

Explicitly restores a domain that can no longer be renewed, if the registry supports this function.

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

## Path parameters

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

## Request body

- object
  - `premium_price` string: Required as confirmation of the price, only if the domain is premium.

## Response `201`

Domain restore created

- object
  - `data` DomainRestore, required
    - `id` integer, required
    - `domain_id` integer, required
    - `state` 'new' | 'restoring' | 'restored' | 'cancelled', 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.
- `401`: The authentication credentials are invalid.
- `404`: The requested resource doesn't exist.

## Changes

- **2026-09-17** (v2) `079e0a7250a7`: 1 info
  - api operation id `domainRestore` removed and replaced with `restoreDomain`
- **2025-07-11** (v2) `06780be0ef17`: 10 info
  - the response property `data` became required for the status `201`
  - the response property `data/created_at` became required for the status `201`
  - the response property `data/domain_id` became required for the status `201`
  - the response property `data/id` became required for the status `201`
  - …6 more
- **2024-02-19** (v2) `cb431b6bd24c`: 1 info
  - endpoint added
- **2023-07-18** (v2) `c8591dcf8c29`: 1 breaking
  - api path removed without deprecation

[Operation history](https://skmtc.dev/dnsimple/apis/dnsimple-api/changes/:account/registrar/domains/:domain/restores/post.md)

---

[API](https://skmtc.dev/dnsimple/apis/dnsimple-api.md) - [All operations](https://skmtc.dev/dnsimple/apis/dnsimple-api/llms.txt) - [OpenAPI document](https://skmtc.dev/dnsimple/apis/dnsimple-api/revisions/2d2e7a8fb60a?raw)