---
category: [Administration & Integrations, Platform and Product Extensions, Platform and Product Extensions/Integration, Administration & Integrations/Custom Integrations & Apps, Platform and Product Extensions/Workday Extend]
keyword: [Extend, PMD Scripting, Scripts]
nav: wcp_docs
parent_url: /wcp_docs/
title: filter (list, key, value)
layout: subsection
---

## <a id="section_m3p_myb_5db"></a>Description

Returns a filtered list of Objects whose key value matches the comparison value.

## <a id="section_cyq_j1m_zsb"></a>Return Type

`List`

## <a id="section_dz5_pwg_5db"></a>Namespace Function Syntax

```
list:filter(list, key, value)
```

<table><thead><tr><th>Parameter</th><th>Description</th></tr></thead><tbody><tr><td>list</td><td>A list of object maps to filter.</td></tr><tr><td>key</td><td>An attribute key in the map list.</td></tr><tr><td>value</td><td>A comparison value.</td></tr></tbody></table><br/>

<b>Example</b>

Assume <i>theList</i> is <i>[{"key": "value0"}, {"key": "value1"}, {"key": "value2"}]</i>.

`list:filter(theList, 'key', 'value0')`

Returns `[{"key", "value0"}]`