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
Only return items that were created during the given date interval.
- created.
gtinteger Minimum value to filter by (exclusive)
- created.
gteinteger Minimum value to filter by (inclusive)
- created.
ltinteger Maximum value to filter by (exclusive)
- created.
lteinteger Maximum value to filter by (inclusive)
- ending_
beforestring A cursor for use in pagination.
ending_
is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting withbefore obj_
, your subsequent call can includebar ending_
in order to fetch the previous page of the list.before=obj_ bar - limitinteger
A limit on the number of objects to be returned. Limit can range between 1 and 100, and the default is 10.
- starting_
afterstring A cursor for use in pagination.
starting_
is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending withafter obj_
, your subsequent call can includefoo starting_
in order to fetch the next page of the list.after=obj_ foo
Returns
A dictionary with a data
property that contains an array of up to limit
items, starting after item starting_
. Each entry in the array is a separate ValueListItem
object. If no more items are available, the resulting array will be empty.
{ "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" } ]}