Delete List

DELETE

/v1/lists/{id}

Delete a list from the account.
Once removed, the list will no longer be accessible.

Credit Note: Deleting list does not consume credits.

INFO

Requires the lists:write OAuth2 scope.

Request

Authorization

API Key

Add parameter in header

X-Api-Key

Example:

X-Api-Key: ********************

Path Params

Query Params

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request DELETE 'https://api.leadfeeder.com/v1/lists/company_123?account_id=123456' \
--header 'X-Api-Key: <api-key>'

🟢200OK

application/json

Success

Bodyapplication/json

Example

{
    "data": null,
    "meta": {
        "request_id": "cf054205-dd8c-4473-8689-07c30fe0789f"
    }
}

🟠400Bad Request

🟠401Unauthorized

🟠403Forbidden

🟠404Record Not Found

🟠429Server Error

🔴500Server Error

🔴504Gateway Timeout

Modified at 2026-06-30 11:47:49