---
title: "getItemDescriptors"
slug: "api/catalog/operations/getitemdescriptors"
sidebar:
  order: 217
---

<a id="ref-ad916ecd1515"></a>
<a id="ref-6bf2297160b0"></a>
<a id="ref-08a3cd196a28"></a>

## Synopsis

```text
ItemDescriptor[] getItemDescriptors(SessionId sessionId,                                                          string catalogId,                                                              string[]        descrIds,                                                           LookupOptions *options)                throws CatalogServiceFault;
```

See also: [`ItemDescriptor`](/pCon/configuratorOnline/specs/api/catalog/types/itemdescriptor#ref-dc44933230ad), [`SessionId`](/pCon/configuratorOnline/specs/api/session/types/sessionid#ref-02e397c8fdb4), [`LookupOptions`](/pCon/configuratorOnline/specs/api/catalog/types/lookupoptions#ref-f00baad6fc12), [`CatalogServiceFault`](/pCon/configuratorOnline/specs/api/catalog/faults/catalogservicefault#ref-f8dbfd6fd5d6)

The operation returns information about the descriptors identified by the descriptor IDs listed with the `descrIds` parameter. If one of these descriptor IDs does not identify a descriptor, the operation fails.

Most lookup options, if specified, are ignored. The only lookup options that are used are `languages`, `subCategories` and `synonyms`.

The `languages` option may be used to select the language of returned synonyms. Synonyms are returned if the `synonyms` option is true. Sub-categories of categories are returned if the `subCategories` option is true.

Deviating from other operations, the default value of the `subCategories` and `synonyms` options is true.

While the current implementation returns the descriptor information in the order of the descriptor IDs passed to the operation, this behavior should not be taken for granted.

Note that the actual type returned for category descriptors is [ItemCategory](/pCon/configuratorOnline/specs/api/catalog/types/itemcategory), which is an extension of (derived from) [`ItemDescriptor`](/pCon/configuratorOnline/specs/api/catalog/types/itemdescriptor).
