Sample - Stripe API
GET/v1/radar/value_lists/{value_list}

Get a Radar value list

Retrieves a Radar value list and its configured items. Use the value list identifier to inspect its alias, item type, metadata, creator, and current list items.

  • RetriesRetries up to 2×, 500ms backoff, 30s timeout.

2 parameters
value_liststringrequired
The unique identifier of the value list, up to 5,000 characters.
expandarray<string>optional
Fields to expand in the returned value list; each value can be up to 5,000 characters.

2 status codes
200Returns a value list containing its alias, creation time, creator, identifier, item type, nested list items, livemode, metadata, name, and object type.
aliasstringrequired
The name of the value list for use in rules.
createdintegerrequired
Time at which the object was created. Measured in seconds since the Unix epoch.
created_bystringrequired
The name or email address of the user who created this value list.
idstringrequired
Unique identifier for the object.
item_typestringrequired
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`.
Allowed:accountcard_bincard_fingerprintcase_sensitive_stringcountrycrypto_fingerprintcustomer_idemailip_addresssepa_debit_fingerprintstringus_bank_account_fingerprint
list_itemsobjectrequired
List of items contained within this value list.
livemodebooleanrequired
If the object exists in live mode, the value is `true`. If the object exists in test mode, the value is `false`.
metadataobjectrequired
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.
namestringrequired
The name of the value list.
objectstringrequired
String representing the object's type. Objects of the same type share the same value.
Allowed:radar.value_list
defaultError response.
errorobjectrequired

Error handling

value_list must be a string no longer than 5,000 characters identifying the value list. Each value in expand must also be a string no longer than 5,000 characters.