---
schema_version: "1"
id: 71d7d5fc3368812fb07c4f0a38b07051b8026751445126bf3ba5f940ce48c589
title: getItemByPKey(pKeyValue)
collection: admin
version: current
locale: en-us
portal_url: https://docs.salesforce.com/admin/current/en-us/ind/264-0-0/cg_modeler_listobject_getitem_pkey.md
canonical_url: https://help.salesforce.com/s/articleView?id=ind.cg_modeler_listobject_getitem_pkey.htm&release=264.0.0&type=5
source_site: help.salesforce.com
content_type: documentation
content_hash: 32f03c40c85817ea5d18a615e137926fa1a2c961239d43f53858cc84faa51a11
description: Searches for an item within the list for the given PKey and returns it. Returns null if no items or multiple items have been found.
products:
  - Consumer Goods
release: "264"
---
# getItemByPKey(pKeyValue)

Searches for an item within the list for the given PKey and returns it. Returns null if no items or multiple items have been found.

### Required Editions

<table class="slds-table slds-table_bordered slds-max-medium-table_stacked slds-m-bottom_small edition"><colgroup><col></colgroup><tbody><tr class=""><td class="slds-cell-wrap" style="vertical-align:top;">Available in: Lightning Experience in <strong>Professional</strong>, <strong>Unlimited</strong>, and <strong>Enterprise</strong> Editions that have Consumer Goods Cloud enabled.</td></tr></tbody></table>

## Parameters

pKey Value: Object

## Returns

Object: The list item corresponding to the given pkey value.

![Example](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-ind-consumer_goods_retail_vscode_modeler-264-0-0-production-enus/87cab158-9245-45b0-9080-f17a57d69ec9/images/icon_example.png)

Example

```
Var list = SomeListObject
Var item = List.getItemByPKey("a16characterpkey")
```