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

# Remove Whitelist

> Delete an empty whitelist.

**[MCP scope](https://apidocs.finrock.io/api-reference/mcp-scopes.md):** `dac.write`

Use this endpoint to delete a whitelist. The whitelist must be empty, so remove its addresses first with [Remove Whitelist Address](https://apidocs.finrock.io/api-reference/whitelists/remove-whitelist-address.md).

> [!WARNING]
>
> A deleted whitelist no longer appears in [List Whitelists](https://apidocs.finrock.io/api-reference/whitelists/list-whitelists.md) and can't be restored. To switch a whitelist off without deleting it, use [Edit Whitelist](https://apidocs.finrock.io/api-reference/whitelists/edit-whitelist.md) with `is_active` set to `false`.

## Body Parameters

**guid** `string` *required*

The ID of the whitelist to delete, from [List Whitelists](https://apidocs.finrock.io/api-reference/whitelists/list-whitelists.md).

```bash cURL theme={null}
curl --request DELETE \
     --url https://api.finrock.io/dac/v1/whitelist \
     --header 'Authorization: Bearer {JWT}' \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --header 'x-api-key: YOUR_API_KEY' \
     --data '{
       "guid": "8fb22996-2cd1-4a2a-9773-ebfde21c6982"
     }'
```

## Response

**code** `integer`

`1000` when the whitelist was deleted.

**error** `string | null`

`null` on success.

**info** `string | null`

Additional information, if any. `null` on success.

```json 200 theme={null}
{
  "code": 1000,
  "error": null,
  "info": null
}
```

## Errors

| Status | When |
| - | - |
| `400` `LIST_MUST_BE_EMPTY` | The whitelist still has addresses on it. |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.