---
title: API Queries - Domain Client Lock/Unlock
description: API Queries - Domain Client Lock/Unlock
---

[Skip to content](https://support.above.com/api-queries-domain-client-lock/unlock#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 - Domain Client Lock/Unlock

Client locking and unlocking domains is achieved using two different functions: lock and unlock. There are several higher levels of locks for domains that cannot be controlled using these functions. You will not be able to unlock a domain if it has been locked at the registrar or registry. Note that some TLDs do not support the client lock function. Additional parameters are required for this function.

Additional Parameters

- domain - Domain name to lock or unlock. Note: [http://www](http://www/). should not be included. Your API key is required and all values should be correctly URL encoded.

Example

In the below example, we will lock the domain "custard.com" (domain=custard.com).

Query

[https://www.above.com/registrar/api/query.html?key=APIKEY&query](https://www.above.com/registrar/api/query.html?key=APIKEY&query)= lock &domain=custard.com

Response

```
<results code="100" />
```

 

Example 2

You cannot unlock a domain that has been registrar, registry or 60 day locked. In this example, we will attempt unlock "handbags.com" (domain=handbags.com).

Query

[https://www.above.com/registrar/api/query.html?key=APIKEY&query=\*\*unlock\*\*&domain=handbags.com](https://www.above.com/registrar/api/query.html?key=APIKEY&query=**unlock**&domain=handbags.com)

Response

```
<results code="1203">  <msg>Domain is locked by registrar</msg></results>
```

 

Error Codes

Possible error responses for this function are:

509 - Specified domain is not in your account  
510 - Domain not specified or invalid domain  
512 - Domain extension must be specified  
1201 - Domain already locked  
1202 - Domain already unlocked  
1203 - Domain is locked by registrar  
1204 - Domain is locked by registry  
1205 - Lock not supported for TLD  
1206 - Cannot unlock domain within 60 days of transfer in  
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)

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