List all value list items 

Returns a list of ValueListItem objects. The objects are sorted in descending order by creation date, with the most recently created object appearing first.

Parameters

  • value_liststringRequired

    Identifier for the parent value list this item belongs to.

  • valuestring

    Return items belonging to the parent list whose value matches the specified value (using an “is like” match).

More parameters

  • createdobject

  • ending_beforestring

  • limitinteger

  • starting_afterstring

Returns

A dictionary with a data property that contains an array of up to limit items, starting after item starting_after. Each entry in the array is a separate ValueListItem object. If no more items are available, the resulting array will be empty.

GET /v1/radar/value_list_items
curl -G https://api.stripe.com/v1/radar/value_list_items \
-u "sk_test_BQokikJ...2HlWgH4olfQ2sk_test_BQokikJOvBiI2HlWgH4olfQ2:" \
-d value_list=rsl_1MxxosLkdIwHu7ixNiiD01Kj
Response
{
"object": "list",
"url": "/v1/radar/value_list_items",
"has_more": false,
"data": [
{
"id": "rsl_1MxxosLkdIwHu7ixNiiD01Kj",
"object": "radar.value_list",
"alias": "custom_ip_blocklist",
"created": 1681760074,
"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_1MxxosLkdIwHu7ixNiiD01Kj"
},
"livemode": false,
"metadata": {},
"name": "Custom IP Blocklist"
}
]
}

Delete a value list item 

Deletes a ValueListItem object, removing it from its parent value list.

Parameters

No parameters.

Returns

Returns an object with the deleted ValueListItem object’s ID and a deleted parameter on success. Otherwise, this call raises an error.

DELETE /v1/radar/value_list_items/:id
curl -X DELETE https://api.stripe.com/v1/radar/value_list_items/rsli_1MxxosLkdIwHu7ixxvA1yKiZ \
-u "sk_test_BQokikJ...2HlWgH4olfQ2sk_test_BQokikJOvBiI2HlWgH4olfQ2:"
Response
{
"id": "rsli_1MxxosLkdIwHu7ixxvA1yKiZ",
"object": "radar.value_list_item",
"deleted": true
}

Cardholders 

An Issuing Cardholder object represents an individual or business entity who is issued cards.

Related guide: How to create a cardholder