# Retrieve a value list

Retrieves a `ValueList` object.

## Prerequisites

Before you can run the following code snippet, you need to call these APIs with the provided parameters to set up the prerequisite API object(s).

1. createRadarValueList
POST /v1/radar/value_lists {"name":"Custom IP Blocklist","alias":"custom_ip_blocklist","item_type":"ip_address"}

## Request

```curl
curl https://api.stripe.com/v1/radar/value_lists/{{VALUE_LIST_ID}} \
  -u "<<YOUR_SECRET_KEY>>"
```

### Response

```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"
}
```

## Returns

Returns a `ValueList` object if a valid identifier was provided.