# The Value List object

### The Value List object

```json
{
  "id": "rsl_1MrQSwLkdIwHu7ixWOGS5c8M",
  "object": "radar.value_list",
  "alias": "custom_ip_blocklist",
  "created": 1680201894,
  "created_by": "API",
  "item_type": "ip_address",
  "list_items": {
    "object": "list",
    "data": [],
    "has_more": false,
    "total_count": 0,
    "url": "/v1/radar/value_list_items?value_list=rsl_1MrQSwLkdIwHu7ixWOGS5c8M"
  },
  "livemode": false,
  "metadata": {},
  "name": "Custom IP Blocklist"
}
```

## Attributes

- `id` (string)
  Unique identifier for the object.

- `object` (string)
  String representing the object’s type. Objects of the same type share the same value.

- `alias` (string)
  The name of the value list for use in rules.

- `created` (timestamp)
  Time at which the object was created. Measured in seconds since the Unix epoch.

- `created_by` (string)
  The name or email address of the user who created this value list.

- `item_type` (enum)
  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`.
Possible enum values:
  - `account`
    Account IDs.

  - `card_bin`
    Card BINs.

  - `card_fingerprint`
    Card fingerprints.

  - `case_sensitive_string`
    Case-sensitive strings.

  - `country`
    Two-letter ISO country codes.

  - `crypto_fingerprint`
    Cryptocurrency fingerprints.

  - `customer_id`
    Customer IDs.

  - `email`
    Email addresses.

  - `ip_address`
    IP addresses.

  - `sepa_debit_fingerprint`
    SEPA debit fingerprints.

  - `string`
    Arbitrary case-insensitive strings.

  - `us_bank_account_fingerprint`
    US bank account fingerprints.

- [`list_items`](https://docs.stripe.com/api/radar/value_lists/object.md?query=list_items) (object)
  List of items contained within this value list.

- `livemode` (boolean)
  If the object exists in live mode, the value is `true`. If the object exists in test mode, the value is `false`.

- `metadata` (map)
  Set of [key-value pairs](https://docs.stripe.com/api/metadata.md) that you can attach to an object. This can be useful for storing additional information about the object in a structured format.

- `name` (string)
  The name of the value list.