---
title: "Purchase a restore for the given domain to bring it out of redemption"
method: POST
path: "/v2/customers/{customerId}/domains/{domain}/redeem"
tags: ["Domains"]
---

# Purchase a restore for the given domain to bring it out of redemption

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

## Path parameters

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

## Headers

- `X-Request-Id` string

## Request body

- DomainRedeemV2
  - `consent` ConsentRedemption, required
    - `price` integer, required — Price for the domain renewal (if domain renewal required for redemption). Please use GET /v2/customers/{customerId}/domains/{domain} to retrieve the redemption price and currency for the domain
    - `fee` integer, required — Fee charged for the domain redemption. Please use GET /v2/customers/{customerId}/domains/{domain} to retrieve the redemption fee and currency for the domain
    - `currency` string, iso-currency-code, required — Currency in which the `price` and `fee` are listed
    - `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

## Response `202`

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

## Other responses

- `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` — Domain invalid
- `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)