> ## Documentation Index
> Fetch the complete documentation index at: https://docs.liquid.tf/llms.txt
> Use this file to discover all available pages before exploring further.

# Delete All Listings

> Remove all your marketplace listings at once

## Overview

Deletes all of your marketplace listings in a single operation. Useful when shutting down a bot or clearing your inventory.

<Warning>
  This action cannot be undone! All your listings will be permanently removed.
</Warning>

## Authentication

<ParamField header="X-API-Key" type="string" required>
  Your site API key
</ParamField>

## Rate Limit

**1 request per minute**

## Request Body

<ParamField body="active_only" type="boolean" required>
  Set to `true` to delete only active listings, or `false` to delete all listings including inactive ones.
</ParamField>

## Response

<ResponseField name="success" type="boolean">
  Returns `true` if all listings were successfully deleted
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl -X DELETE "https://api.liquid.tf/api/dev/listings" \
    -H "Content-Type: application/json" \
    -H "X-API-Key: YOUR_SITE_API_KEY" \
    -d '{ "active_only": true }'
  ```

  ```javascript JavaScript theme={null}
  const response = await fetch('https://api.liquid.tf/api/dev/listings', {
    method: 'DELETE',
    headers: {
      'Content-Type': 'application/json',
      'X-API-Key': 'YOUR_SITE_API_KEY'
    },
    body: JSON.stringify({
      active_only: true
    })
  });

  const data = await response.json();
  ```

  ```python Python theme={null}
  import requests

  response = requests.delete(
      'https://api.liquid.tf/api/dev/listings',
      headers={'X-API-Key': 'YOUR_SITE_API_KEY'},
      json={'active_only': True}
  )

  data = response.json()
  ```
</RequestExample>

<ResponseExample>
  ```json Response theme={null}
  {
    "success": true
  }
  ```
</ResponseExample>

## Active vs All Listings

<AccordionGroup>
  <Accordion title="Active Listings (active_only: true)">
    Deletes only listings that are currently visible on the marketplace. Excludes sold, cancelled, or inactive listings.

    **Use case:** Clearing your current inventory while preserving historical data.
  </Accordion>

  <Accordion title="All Listings (active_only: false)">
    Deletes **all** listings including inactive ones. This completely removes your listing history.

    **Use case:** Complete account cleanup or data removal.
  </Accordion>
</AccordionGroup>

<Note>
  Most bots should use `active_only: true` to avoid deleting historical listing data.
</Note>

## Safety Tips

Before calling this endpoint:

1. **Confirm intent** - Make sure you really want to delete all listings
2. **Backup data** - Export your listings if you need them later
3. **Test first** - Try deleting individual listings to ensure your API key works
4. **Use active\_only** - Unless you need to delete everything, use `active_only: true`