---
title: "Delete a value list"
method: DELETE
path: "/v1/radar/value_lists/{value_list}"
---

# Delete a value list

`DELETE /v1/radar/value_lists/{value_list}`

Deletes a `ValueList` object, also deleting any items contained within the value list. To be deleted, a value list must not be referenced in any rules.

## Path parameters

- `value_list` string, required

## Response `200`

Successful response.

- DeletedRadarValueList
  - `deleted` true, required — Always true for a deleted object
  - `id` string, required — Unique identifier for the object.
  - `object` 'radar.value_list', required — String representing the object's type. Objects of the same type share the same value.

## Other responses

- `default` — Error response.

## Changes

> 51 revisions in range; 14 not diffed, 6 could not be searched.

- **2025-11-05** `62e8dc4ed869` — 1 info
  - added the optional property `error/payment_intent/payment_method_options/anyOf[subschema #1: PaymentIntentPaymentMethodOptions]/card_present/anyOf[subschema #1: payment_method_options_card_present]/capture_method` to the response with the `default` status
- **2025-10-22** `1e483c60b480` — 1 info
  - added the optional property `error/payment_intent/amount_details/anyOf[subschema #1: PaymentFlowsAmountDetails]/line_items/data/items/payment_method_options/anyOf[subschema #1: PaymentFlowsAmountDetailsResourceLineItemsListResourceLineItemResourcePaymentMethodOptions]/klarna/subscription_reference` to the response with the `default` status
- **2025-08-19** `7b79777e9bbd` — 2 info
  - added the optional property `error/payment_intent/latest_charge/anyOf[subschema #2: Charge]/payment_method_details/anyOf[subschema #1: payment_method_details]/paynow/location` to the response with the `default` status
  - added the optional property `error/payment_intent/latest_charge/anyOf[subschema #2: Charge]/payment_method_details/anyOf[subschema #1: payment_method_details]/paynow/reader` to the response with the `default` status
- …earlier changes not shown

[Full history](https://skmtc.dev/stripe/apis/spec3/changes/v1/radar/value_lists/:value_list/delete.md)

---

[API](https://skmtc.dev/stripe/apis/spec3.md) · [All operations](https://skmtc.dev/stripe/apis/spec3/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/stripe/spec3/revisions/f0e0fc8fffbf/schema)