---
schema_version: "1"
id: c1820297048ad3b685e006b3059f9d0db2f04420234a9748b0abdf2cfa0e677c
title: Retrieve
collection: developer
version: current
locale: en-us
portal_url: https://docs.salesforce.com/developer/current/en-us/marketing-cloud/guides/mc-programmatic-content/ssjs_listRetrieve.md
canonical_url: https://developer.salesforce.com/docs/marketing/marketing-cloud/guide/ssjs_listRetrieve.html
source_site: developer.salesforce.com
content_type: documentation
content_hash: 586ac812bc864c29b94a91f154b6c2542bc96edb1d3e0cb9cb13649d971f6f4a
products:
  - Marketing Cloud Engagement APIs and Programmatic Languages
  - Marketing Cloud
---
# Retrieve

## Overview

Retrieves a list based on the specified criteria

### Syntax

Retrieve(1)

### Function Properties

<!--complex table-->

| Ordinal | Type   |              | Description                          |
| ------- | ------ | ------------ | ------------------------------------ |
| **1**   | string | **Required** | Criteria used to search for the list |

## Example

This sample code retrieves a list based on the specified filter criteria.

```
var lists = List.Retrieve({Property:"ListName",SimpleOperator:"equals",Value:"BirthdayList"});
```