---
schema_version: "1"
id: 8e170419dd1e05ed468aff9b01ac18825f0b3b120cdb0e6886a8c97a3a89fe6d
title: Subscribers.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_listSubscribersRetrieve.md
canonical_url: https://developer.salesforce.com/docs/marketing/marketing-cloud/guide/ssjs_listSubscribersRetrieve.html
source_site: developer.salesforce.com
content_type: documentation
content_hash: 9a0f5751e2e3c6a2ccebb7275f54a592636b45bf86b42d7d4a36b408192a9a9f
products:
  - Marketing Cloud Engagement APIs and Programmatic Languages
  - Marketing Cloud
---
# Subscribers.Retrieve

## Overview

Retrieves a list of subscribers based on the passed filter. The call returns an EmailTypePreference value only if the call involves a single subscriber.

### Syntax

Subscribers.Retrieve(1)

### Function Properties

<!--complex table-->

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

## Example

This sample code returns a list of subscribers based on the specified criteria.

```
var myList = List.Init('MyList');
var subs = myList.Subscribers.Retrieve({Property:"CustomerID", SimpleOperator:"equals", Value:"TestList"});
```