---
title: Clear Searches
slug: valueserp/batches-api/searches/clear
docTags: 
createdAt: 2024-08-03T11:00:15.050Z
---

# Clear Searches

All of the Searches in a batch can be cleared by making an  `HTTP DELETE` request to the  `/batches/BATCH_ID/clear` endpoint (where  `BATCH_ID` is the  `id` of the Batch).

:::hint{type="info"}
**Batch Status**
Batches can only be cleared from a Batch when it is not running. To check whether a Batch is currently running use the [Get Batch](https://docs.trajectdata.com/valueserp/batches-api/batches/get) endpoint.
:::

***

### Example

<font color="#f5222d">`DELETE`</font>  `/batches/BATCH_ID/clear`

In the example below we clear a Batch with  `id=123456` :

:::CodeblockTabs
```curl
$ curl -X DELETE "https://api.valueserp.com/batches/123456/clear?api_key=demo"
```

```nodejs
const axios = require('axios');
const params = {
  api_key: 'demo'
}

axios.delete('https://api.valueserp.com/batches/123456/clear', { params })
  .then(response => {

    console.log('Search deleted.');

  }).catch(error => {
    console.log(error);
  });
```

```python
import requests

api_result = requests.delete('https://api.valueserp.com/batches/123456/clear?api_key=demo')

print ("Search deleted.")
```

```php
<?php
      
$queryString = http_build_query([
  'api_key' => 'demo',
]);

$ch = curl_init(sprintf('%s?%s', 'https://api.valueserp.com/batches/123456/clear', $queryString));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_FOLLOWLOCATION, true);
# the following options are required if you're using an outdated OpenSSL version
# more details: https://www.openssl.org/blog/blog/2021/09/13/LetsEncryptRootCertExpire/
curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, false);
curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false);
curl_setopt($ch, CURLOPT_TIMEOUT, 180);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "DELETE");

$json = curl_exec($ch);
curl_close($ch);

echo "Search deleted.", PHP_EOL;

?>
```
:::

VALUE SERP responds with a JSON object confirming that the batch has been cleared:

```json
{
  "request_info": {
    "success": true,
    "message": "Batch searches cleared"
  }
}
```

***

**Next Steps**
     [Update Search](https://docs.trajectdata.com/valueserp/batches-api/searches/update)
     [List Search](https://docs.trajectdata.com/valueserp/batches-api/searches/list)