---
title: "Create a value list"
method: POST
path: "/v1/radar/value_lists"
---

# Create a value list

`POST /v1/radar/value_lists`

Creates a new `ValueList` object, which can then be referenced in rules.

## Response `200`

Successful response.

- RadarValueList — Value lists allow you to group values together which can then be referenced in rules. Related guide: [Default Stripe lists](https://docs.stripe.com/radar/lists#managing-list-items)
  - `alias` string, required — The name of the value list for use in rules.
  - `created` integer, required — Time at which the object was created. Measured in seconds since the Unix epoch.
  - `created_by` string, required — The name or email address of the user who created this value list.
  - `id` string, required — Unique identifier for the object.
  - `item_type` 'account' | 'card_bin' | 'card_fingerprint' | 'case_sensitive_string' | 'country' | 'crypto_fingerprint' | 'customer_id' | 'email' | 'ip_address' | 'sepa_debit_fingerprint' | 'string' | 'us_bank_account_fingerprint', required — The type of items in the value list. One of `card_fingerprint`, `card_bin`, `crypto_fingerprint`, `email`, `ip_address`, `country`, `string`, `case_sensitive_string`, `customer_id`, `account`, `sepa_debit_fingerprint`, or `us_bank_account_fingerprint`.
  - `list_items` object, required — List of items contained within this value list.
    - `data` RadarValueListItem[], required — Details about each object.
      - `created` integer, required — Time at which the object was created. Measured in seconds since the Unix epoch.
      - `created_by` string, required — The name or email address of the user who added this item to the value list.
      - `id` string, required — Unique identifier for the object.
      - `livemode` boolean, required — If the object exists in live mode, the value is `true`. If the object exists in test mode, the value is `false`.
      - `object` 'radar.value_list_item', required — String representing the object's type. Objects of the same type share the same value.
      - `value` string, required — The value of the item.
      - `value_list` string, required — The identifier of the value list this item belongs to.
    - `has_more` boolean, required — True if this list has another page of items after this one that can be fetched.
    - `object` 'list', required — String representing the object's type. Objects of the same type share the same value. Always has the value `list`.
    - `url` string, required — The URL where this list can be accessed.
  - `livemode` boolean, required — If the object exists in live mode, the value is `true`. If the object exists in test mode, the value is `false`.
  - `metadata` object, required — Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format.
  - `name` string, required — The name of the value list.
  - `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.

---

[API](https://skmtc.net/stripe/apis/stripe-api.md) · [All operations](https://skmtc.net/stripe/apis/stripe-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/stripe/stripe-api/versions/707de00b0616/schema)