---
title: "Get domain renewal info"
method: GET
path: "/domains/{name}/renewals"
tags: ["domain-registration"]
---

# Get domain renewal info

`GET /domains/{name}/renewals`

Retrieve renewal eligibility and pricing for the specified domain, including the current expiration date, grace period expiration, and available renewal periods.

## Path parameters

- `name` string, required

## Response `200`

Domain renewal pricing and eligibility

- IcannDomainRenewalInfoResponse
  - `@type` 'unstoppabledomains.com/partner.v3.DomainRenewalInfo', required
  - `isEligible` boolean, required
  - `expirationDate` string, required
  - `gracePeriodExpirationDate` string
  - `price` DomainPriceResponse
    - `type` 'STANDARD' | 'PREMIUM' | 'DEFERRED', required
    - `listPrice` PriceItemResponse, required
      - `usdCents` number, required
    - `adjustments` DomainPriceAdjustmentResponse[]
      - `usdCents` number, required
      - `type` string, required
    - `subTotal` PriceItemResponse, required
      - `usdCents` number, required
    - `validUntilTimestamp` number
  - `period` IcannDomainRenewalInfoPeriodResponse, required
    - `min` number, required
    - `max` number, required
    - `increments` number, required

## Other responses

- `400` — Invalid request
- `401` — Authentication required
- `403` — Insufficient permissions
- `404` — Resource not found
- `500` — Internal server error

---

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