---
title: API Queries - Delete Domains
description: API Queries - Delete Domains
---

[Skip to content](https://support.above.com/api-queries-delete-domains#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 - Delete Domains

The delete\_domains function removes domains from your Monetization Portfolio Manager account (up to 1,000 at a time - see note below). Additional parameters are required for this function.

#### **Additional Parameters**

- domains - The domain or domains to be removed from your account, comma separated (up to 1,000 per query - see note below). (Required)

Note: For larger queries (when removing more than 100 domains at a time), you MUST use a POST request to ensure you do not reach any request length limitations.

Note: Make sure to URL encode all values.

#### **Example query and response:**

In this example, we will delete the domains abc123.com, efg456.com and lmn789.net (domains=abc123.com,efg456.com,lmn789.net).

Note: This function will return the status "Success", even if the domains have already been deleted. Also note that domains are not completely removed from your account, they are moved to the "(Trash)" folder.

Example query:

[https://www.above.com/api.php?username=user&password=pass&api\_key=key&mode=delete\_domains&domains](https://www.above.com/api.php?username=user&password=pass&api_key=key&mode=delete_domains&domains)= abc123.com,efg456.com,lmn789.net

Response:

```
    <results status="Success" />    <info>    <result message="3 domains deleted" />    </info>
```

 

Note: If the domains have already been deleted from your account (they are in the "(Trash)" folder, you will not receive an error. This will be the response:

```
    <results status="Success" />    <info>    <result message="3 domains are already deleted" />    </info>
```

 

Note: If the domains specified do not exist in your account, you will not receive an error. This will be the response:

```
    <results status="Success" />    <info/>
```

 

If many domains are being deleted and the task takes longer than 30 seconds a jobid will be provided. See the example below:

Example query:

[https://www.above.com/api.php?username=user&password=pass&api\_key=key&mode=delete\_domains&domains=domain515.com](https://www.above.com/api.php?username=user&password=pass&api_key=key&mode=delete_domains&domains=domain515.com), domain032.com,domain041.com,+ many more domains

Response:

```
    <results>    <result jobid="12345" status="Processing"/>    </results>
```

 

You can then view the progress using the jobid with the Job Status function.

#### **Error Responses:**

Possible error responses for this function are:

410 - No domain or domains parameter passed  
500 - Job failed. Please contact support if problems persist.  
General errors, such as 200 - Internal Error or 300 - Username or password invalid.

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)