---
title: "getChoiceList"
slug: "api/basket/operations/getchoicelist"
sidebar:
  order: 451
---

<a id="ref-0ea8982a21e5"></a>
<a id="ref-2aa057b768e7"></a>
<a id="ref-64f6b58166df"></a>

## Synopsis

```text
PropertyValue[] getChoiceList(SessionId sessionId,
    BItemId itemId,
    string propClass,
    string propName,
    GetChoiceListOptions options
)
throws BasketServiceFault;
```

See also: [PropertyValue](/pCon/configuratorOnline/specs/api/basket/types/propertyvalue#ref-b8966dce86cf), [SessionId](/pCon/configuratorOnline/specs/api/session/types/sessionid#ref-02e397c8fdb4), [BItemId](/pCon/configuratorOnline/specs/api/basket/types/bitemid#ref-bccb6c926e5b), [GetChoiceListOptions](/pCon/configuratorOnline/specs/api/basket/types/getchoicelistoptions#ref-9a7313077020), [BasketServiceFault](/pCon/configuratorOnline/specs/api/basket/faults/basketservicefault#ref-d5adb74faa1b)

The `getChoiceList` operation returns the list of allowed property values[^1] for a single property.

The `itemId` parameter must identify an article item that is part of the basket item tree maintained by the basket service for the session identified by the `sessionId` parameter.

The `propClass` and `propName` parameters must identify a property of the article. The returned choice list is empty if the property happens to be an internal property[^2] or a property explicitly hidden by relation knowledge, or if the `choiceList` field of the [`Property`](/pCon/configuratorOnline/specs/api/basket/types/property) structure is `false`. Otherwise, the choice list is not empty and contains at least the current property value.

See [PropertyValue](/pCon/configuratorOnline/specs/api/basket/types/propertyvalue#ref-b8966dce86cf) for a description of the `PropertyValue` structure which is used as the element type of the returned sequence.

A [`BasketServiceFault`](/pCon/configuratorOnline/specs/api/basket/faults/basketservicefault) is returned if any of the following conditions occurs:

- The `sessionId` parameter is not a valid string representation of an UUID or does not represent an open session.

- The `itemId` parameter does not represent an UUID.

- The `itemId` parameter does not identify an article item.

- The `propClass` and `propName` parameters do not identify a property of the article.

[^1]: If the `addValues` field of the `Property` structure is `true`, then the choice list contains only proposed values.

[^2]: This is condition is quite unlikely as the current version of the basket service does not expose internal properties.
