---
title: "Retrieve a value list item"
method: GET
path: "/v1/radar/value_list_items/{item}"
---

# Retrieve a value list item

`GET /v1/radar/value_list_items/{item}`

## Request

- Base URL: `https://api.stripe.com`
- URL: `https://api.stripe.com/v1/radar/value_list_items/{item}`
- Auth: one of:
  - HTTP basic
  - HTTP bearer

Retrieves a `ValueListItem` object.

## Path parameters

- `item` string, required

## Query parameters

- `expand` string[]

## Response `200`

Successful response.

- RadarValueListItem: Value list items allow you to add specific values to a given Radar value list, which can then be used in rules. Related guide: [Managing list items](https://docs.stripe.com/radar/lists#managing-list-items)
  - `created` integer, required: Time at which the object was created. Measured in seconds since the Unix epoch.
  - `created_by` string, required: The name or email address of the user who added this item to the value list.
  - `id` string, required: Unique identifier for the object.
  - `livemode` boolean, required: If the object exists in live mode, the value is `true`. If the object exists in test mode, the value is `false`.
  - `object` 'radar.value_list_item', required: String representing the object's type. Objects of the same type share the same value.
  - `value` string, required: The value of the item.
  - `value_list` string, required: The identifier of the value list this item belongs to.

## Other responses

- `default`: Error response.

---

[API](https://skmtc.dev/stainless-api/apis/stripe-api.md) · [All operations](https://skmtc.dev/stainless-api/apis/stripe-api/llms.txt) · [OpenAPI document](https://skmtc.dev/stainless-api/apis/stripe-api/revisions/7cff4cc46d06?raw)