--- title: API Queries - Renew Domain description: API Queries - Renew Domain --- [Skip to content](https://support.above.com/api-queries-renew-domain#main-content) ![above-logo-466-1](https://support.above.com/hs-fs/hubfs/above-logo-466-1.png?width=230&height=43&name=above-logo-466-1.png) - [Buy Domains](https://www.above.com/marketplace/index.html) - [Sell Domains](https://www.above.com/sell-my-domains.html) - [Monetize](https://www.above.com/monetization.html) - [Register](https://www.above.com/registrar/index.html) - About Show submenu for About - [About Us](https://www.above.com/about.html) - [Above & Beyond Club](https://www.above.com/above-beyond-club.html) - [Brokerage](https://www.above.com/domain-brokerage.html) - [Contact Us](https://www.above.com/contact.html) - [Our Team](https://www.above.com/our-team.html) - [Log In](https://www.above.com/login.html) Open main navigation Close main navigation - [Buy Domains](https://www.above.com/marketplace/index.html) - [Sell Domains](https://www.above.com/sell-my-domains.html) - [Monetize](https://www.above.com/monetization.html) - [Register](https://www.above.com/registrar/index.html) - About Show submenu for About - [About Us](https://www.above.com/about.html) - [Above & Beyond Club](https://www.above.com/above-beyond-club.html) - [Brokerage](https://www.above.com/domain-brokerage.html) - [Contact Us](https://www.above.com/contact.html) - [Our Team](https://www.above.com/our-team.html) - [Log In](https://www.above.com/login.html) How can we help you? - There are no suggestions because the search field is empty. 1. [Above.com FAQ](https://support.above.com/?hsLang=en) 2. [Above.com Help Guides](https://support.above.com/above-com-help-guides?hsLang=en) # API Queries - Renew Domain The renew API function renews a domain for a specified number of years. Renewed years are added to the expiry date of your domain. Note that there are limits on the minimum and maximum number of years some domains can be registered. You will receive an error if the number of years provided is outside of this range. Some registries also limit the number of renewals that can be performed per day. It is recommended you use the Check Pricing and Check Balance functions to check the domain cost and that your account balance is adequate before proceeding. The funds will be deducted from your account balance or an error will be returned if you do not have sufficient funds. Additional parameters are required for this function. Additional Parameters - domain - Domain name to renew. Note: [http://www](http://www/). should not be included. - renew\_year - Number of years to extend your domain registration by. Your API key is required and all values should be correctly URL encoded. Example 1 In the below example, we will renew the domain "shoes.com" (domain=shoes.com). There are various errors that could be returned and need to be handled by your custom application such as insufficient funds or domain not in your account. Query [https://www.above.com/registrar/api/query.html?key=APIKEY&query=\*\*renew\*\*&domain=shoes.com&renew\_year=2](https://www.above.com/registrar/api/query.html?key=APIKEY&query=**renew**&domain=shoes.com&renew_year=2) Response ``` ```   Example 2 In this example we will attempt to renew a domain for 12 years, which is beyond what we allow. We will use the domain "laces.com" (domain=laces.com). Query [https://www.above.com/registrar/api/query.html?key=APIKEY&query=\*\*renew\*\*&domain=laces.com&renew\_year=12](https://www.above.com/registrar/api/query.html?key=APIKEY&query=**renew**&domain=laces.com&renew_year=12) Response ```              Renewal years must be 1-10 years      ```   Error Codes Possible error responses for this function are: 508 - Insufficient balance 509 - Specified domain is not in your account 510 - Domain not specified or invalid domain 512 - Domain extension must be specified 514 - Domain is pending update or registrar/registry locked 801 - Renewal years not specified or value is not a valid number 802 - Renew Request exceeds the registry's policy limits 803 - Renewal years must be 1-10 years 804 - Renewal not allowed for this TLD General errors, such as 401 - Invalid API key or 500 - System unavailable. For a complete list of error responses, see the [Error Codes manual page](https://support.above.com/api-error-codes?hsLang=en). - [Above.com Help Guides](https://support.above.com/above-com-help-guides?hsLang=en) - [Monetization FAQs](https://support.above.com/monetization-faqs?hsLang=en#main-content) - [Getting Started](https://support.above.com/monetization-faqs?hsLang=en#getting-started) - [Above Maximizer](https://support.above.com/monetization-faqs?hsLang=en#above-maximizer) - [Account Maintenance](https://support.above.com/monetization-faqs?hsLang=en#account-maintenance) - [Getting Paid](https://support.above.com/monetization-faqs?hsLang=en#getting-paid) - [Stats and Reports](https://support.above.com/monetization-faqs?hsLang=en#stats-and-reports) - [Monetization & Portfolio Manager API](https://support.above.com/monetization-faqs?hsLang=en#monetization-portfolio-manager-api) - [Other Questions](https://support.above.com/monetization-faqs?hsLang=en#other-questions) - [Marketplace FAQs](https://support.above.com/marketplace-faqs?hsLang=en#main-content) - [Selling](https://support.above.com/marketplace-faqs?hsLang=en#selling) - [Buying](https://support.above.com/marketplace-faqs?hsLang=en#buying) - [Other](https://support.above.com/marketplace-faqs?hsLang=en#other) - [Registrar FAQs](https://support.above.com/registrar-faqs?hsLang=en#main-content) - [Registration](https://support.above.com/registrar-faqs?hsLang=en#registration) - [Transfer](https://support.above.com/registrar-faqs?hsLang=en#transfer) - [DNS](https://support.above.com/registrar-faqs?hsLang=en#dns) - [Verification](https://support.above.com/registrar-faqs?hsLang=en#verification) - [Two Step Authentication](https://support.above.com/registrar-faqs?hsLang=en#two-step-authentication) - [API](https://support.above.com/registrar-faqs?hsLang=en#api) - [Other](https://support.above.com/registrar-faqs?hsLang=en#other) - [Portfolio Manager FAQs](https://support.above.com/portfolio-manager-faqs?hsLang=en#main-content) - [Features](https://support.above.com/portfolio-manager-faqs?hsLang=en#features) - [Account Maintenance](https://support.above.com/portfolio-manager-faqs?hsLang=en#account-maintenance) - [Stats and Reports](https://support.above.com/portfolio-manager-faqs?hsLang=en#stats-and-reports) - [Monetization & Portfolio Manager API](https://support.above.com/portfolio-manager-faqs?hsLang=en#monetization-portfolio-manager-api) - [Domain Consolidate](https://support.above.com/portfolio-manager-faqs?hsLang=en#domain-consolidate) - [Other](https://support.above.com/portfolio-manager-faqs?hsLang=en#other) - [Portfolio Manager Manual](https://support.above.com/portfolio-manager-manual?hsLang=en#main-content) - [Introduction](https://support.above.com/portfolio-manager-manual?hsLang=en#introduction) - [Interface](https://support.above.com/portfolio-manager-manual?hsLang=en#interface) - [Portfolio Manager](https://support.above.com/portfolio-manager-manual?hsLang=en#portfolio-manager) - [Sell Domains](https://support.above.com/portfolio-manager-manual?hsLang=en#sell-domains) - [Offers Received](https://support.above.com/portfolio-manager-manual?hsLang=en#offers-received) - [Registrar](https://support.above.com/portfolio-manager-manual?hsLang=en#registrar) - [Monetization API](https://support.above.com/portfolio-manager-manual?hsLang=en#monetization-api) - [Registrar API](https://support.above.com/portfolio-manager-manual?hsLang=en#registrar-api) - [My Account Manual](https://support.above.com/portfolio-manager-manual?hsLang=en#my-account-manual) - [Column Descriptions](https://support.above.com/portfolio-manager-manual?hsLang=en#column-descriptions) - [Domain Details](https://support.above.com/portfolio-manager-manual?hsLang=en#domain-details) - [Supported Domains (TLDs)](https://support.above.com/portfolio-manager-manual?hsLang=en#supported-domains-tlds) - [Support and Help](https://support.above.com/portfolio-manager-manual?hsLang=en#support-and-help) - [Monetization Quick-Start Guide](https://support.above.com/monetization-quick-start-guide?hsLang=en) [![Above.com Logo](https://support.above.com/hs-fs/hubfs/above-logo-466.png?width=466&height=88&name=above-logo-466.png "Above.com Logo")](https://www.above.com) [mailto:email@email.com](mailto:email@email.com) Copyright © 2026, Trillion Pty Ltd Domain Registrar [Register Domains](https://www.above.com/registrar/index.html) [Pricing](https://www.above.com/registrar/domain-pricing.html) [FAQs](https://www.above.com/registrar/faq.html) [Dispute Policy](https://www.above.com/registrar/domain-dispute-policy.html) [Terms of Service](https://www.above.com/terms-of-service.html#Above.com_Registrar_Terms) [WHOIS](https://www.above.com/registrar/whois.html) Marketplace [Sell My Domains](https://www.above.com/sell-my-domains.html) [Buy Domains](https://www.above.com/marketplace/index.html) [Escrow](https://www.above.com/marketplace/escrow.html) [FAQs](https://www.above.com/marketplace/faq.html) [Terms of Service](https://www.above.com/terms-of-service.html#Above.com_Marketplace_Terms) Monetization [Monetization](https://www.above.com/monetization.html) [Reporting](https://www.above.com/reporting.html) [FAQs](https://www.above.com/faq.html) [Terms of Service](https://www.above.com/terms-of-service.html#Above.com_MAP_Terms) Brokerage [Domain Brokerage](https://www.above.com/domain-brokerage.html) [Sell a Domain](https://www.above.com/domain-brokerage.html#sell-domain) [Buy a Domain](https://www.above.com/domain-brokerage.html#buy-domain) [How It Works](https://www.above.com/domain-brokerage.html#how-it-works) [Meet the Brokers](https://www.above.com/domain-brokerage.html#broker-team) Above/Support [Contact Us](https://www.above.com/contact.html) [About Us](https://www.above.com/about.html) [Our Team](https://www.above.com/our-team.html) [Above & Beyond Club](https://www.above.com/above-beyond-club.html) [Careers](https://www.trillion.com/careers.html) [Blog](https://www.above.com/blog/) [Site Map](https://www.above.com/sitemap.html) Socials [LinkedIn](https://www.linkedin.com/company/abovedomain/) [X.com](https://twitter.com/above_domain) [Facebook](https://www.facebook.com/above.domain) [Instagram](https://www.instagram.com/above_com) Accreditations - ![](https://www.above.com/img/icann_logo.png) - ![](https://www.above.com/img/auda-logo-black.png) - ![](https://www.above.com//img/iso_black.png) Copyright © 2008 - Above.com Pty Ltd - All rights reserved. [Privacy Policy](https://www.above.com/privacy-policy.html)