---
title: API Queries - Register Domain
description: API Queries - Register Domain
---

[Skip to content](https://support.above.com/api-queries-register-domain-r#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. [Portfolio Manager Manual](https://support.above.com/portfolio-manager-manual?hsLang=en)
3. [Registrar API](https://support.above.com/portfolio-manager-manual?hsLang=en#registrar-api)

# API Queries - Register Domain

The register API function registers a new domain. It is recommended you use the [Check Pricing](https://www.above.com/manual/api/reg/api-manual-pricing.html) function to check the domain cost and the [Check Balance](https://www.above.com/manual/api/reg/api-manual-check-balance.html) function to ensure your account balance is adequate before registering a new domain. 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 - Complete domain name to register including the extention. Note: http://www. should not be included.

Your API key is required and all values should be correctly URL encoded.

#### **Example 1**

In the below example, we will register 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, domain already exists or invalid domain.

#### **Query**

https://www.above.com/registrar/api/query.html?key=APIKEY&query=register&domain=shoes.com

#### **Response**

```
<results code="100">     <domains total="1" offset="0" limit="100" sort_by="domain" order="ASC">      <r domain="shoes.com">       <created>2014-05-06 03:47:40</created>       <expiry>2018-05-06 03:47:40</expiry>       <dns1>ns1.abovedomains.com</dns1>       <dns2>ns2.abovedomains.com</dns2>       <technical_contact>260152_673371</technical_contact>       <admin_contact>260152_673371</admin_contact>       <registrant_contact>260152_673371</registrant_contact>       <billing_contact>260152_673371</billing_contact>       <privacy>off</privacy>       <category></category>       <paid></paid>       <value></value>       <keyword></keyword>       <autorenew>off</autorenew>       <status>ok</status>       <lock>On</lock>      </r>     </domains>    </results>
```

 

   

Note: Upon successful registration of a domain, our API returns code 100 to indicate success and the current domain details, similar to using the [Manage Domains function](https://www.above.com/manual/api/reg/api-manual-manage-domains.html).

#### **Example 2 - Unsupported domain extension**

In this example we will attempt to register a .com.au domain which is not supported by Above.com Registrar. We will use domain "clothes.com.au" (domain=clothes.com.au).

#### **Query**

https://www.above.com/registrar/api/query.html?key=APIKEY&query=register&domain=clothes.com.au

#### **Response**

\<results code="605"\>

     \<msg\>TLD not supported by Above.com\</msg\>

    \</results\>

   

#### **Error Codes**

Possible error responses for this function are:

- [508 - Insufficient balance](https://www.above.com/manual/api/reg/api-manual-error-codes.html#508)
- [510 - Domain not specified or invalid domain](https://www.above.com/manual/api/reg/api-manual-error-codes.html#510)
- [512 - Domain extension must be specified](https://www.above.com/manual/api/reg/api-manual-error-codes.html#512)
- [513 - Multiple domains not supported](https://www.above.com/manual/api/reg/api-manual-error-codes.html#513)
- [532 - Multiple connections to API not allowed](https://www.above.com/manual/api/reg/api-manual-error-codes.html#532)
- [601 - Registration failed - domain already registered](https://www.above.com/manual/api/reg/api-manual-error-codes.html#601)
- [602 - Registration failed - internal error](https://www.above.com/manual/api/reg/api-manual-error-codes.html#602)
- [604 - Domain already queued to be registered](https://www.above.com/manual/api/reg/api-manual-error-codes.html#604)
- [605 - TLD not supported by Above.com](https://www.above.com/manual/api/reg/api-manual-error-codes.html#605)
- [606 - No TLD default contact set](https://www.above.com/manual/api/reg/api-manual-error-codes.html#606)
- [607 - Invalid details in domain contact](https://www.above.com/manual/api/reg/api-manual-error-codes.html#607)
- [608 - Domain not available](https://www.above.com/manual/api/reg/api-manual-error-codes.html#608)
- [609 - Registration failed - register limit reached](https://www.above.com/manual/api/reg/api-manual-error-codes.html#609)
- [610 - Registration failed - register function paused](https://www.above.com/manual/api/reg/api-manual-error-codes.html#610)
- General errors, such as [401 - Invalid API key](https://www.above.com/manual/api/reg/api-manual-error-codes.html#401) or [500 - System unavailable](https://www.above.com/manual/api/reg/api-manual-error-codes.html#500).

For a complete list of error responses, see the [Error Codes manual page](https://www.above.com/manual/api/reg/api-manual-error-codes.html).

- [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)

<https://www.facebook.com/> <https://www.twitter.com/> <https://www.instagram.com/> <https://podcasts.apple.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

<https://www.linkedin.com/company/abovedomain/>

[LinkedIn](https://www.linkedin.com/company/abovedomain/)

<https://twitter.com/above_domain>

[X.com](https://twitter.com/above_domain)

<https://www.facebook.com/above.domain>

[Facebook](https://www.facebook.com/above.domain)

<https://www.instagram.com/above_com>

[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)