---
schema_version: "1"
id: e9ae36863e5bd81decaed0f99ae725ace27f83cccaa4b5efddb6849c34b33aae
title: ListSubscriber
collection: developer
version: current
locale: en-us
portal_url: https://docs.salesforce.com/developer/current/en-us/marketing-cloud/guides/mc-apis/listsubscriber.md
canonical_url: https://developer.salesforce.com/docs/marketing/marketing-cloud/guide/listsubscriber.html
source_site: developer.salesforce.com
content_type: documentation
content_hash: 8a38dd32dfbafc85a578aa32a9803bf2e88a65c91a5d3a167ba8577648a94687
products:
  - Marketing Cloud Engagement APIs and Programmatic Languages
  - Marketing Cloud
---
# ListSubscriber

An object that contains information about subscribers for a list or lists for a subscriber. Calls to this object also retrieve any groups to which a subscriber belongs. Perform a call on the specific ID to determine if that ID refers to a list or group.

## Properties

| Name                | Data Type                                      | Description                                                                                                                                               |
| ------------------- | ---------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `Client`            | [ClientID](https://developer.salesforce.com/docs/marketing/marketing-cloud/guide/clientid.md) object                 | Specifies the account ownership and context of an object.                                                                                                 |
| `CorrelationID`     | String                                         | Identifies correlation of objects across several requests.                                                                                                |
| `CreatedDate`       | DateTime                                       | The date and time when the object was created.                                                                                                            |
| `CustomerKey`       | String                                         | User-supplied unique identifier for an object within an object type. This property corresponds to the external key assigned to an object.                 |
| `ID`                | Int                                            | Read-only identifier for an object. Some objects use the ObjectID property as a unique ID.                                                                |
| `ListID`            | Int                                            | Defines identification for a list the subscriber resides on.                                                                                              |
| `ModifiedDate`      | DateTime                                       | The date and time when the object was last modified.                                                                                                      |
| `ObjectID`          | String                                         | System-controlled, read-only text string identifier for object.                                                                                           |
| `ObjectState`       | String                                         | Not used.                                                                                                                                                 |
| `Owner`             | [Owner](https://developer.salesforce.com/docs/marketing/marketing-cloud/guide/owner.md) object                       | Describes account ownership of subscriber in an on-your-behalf account.                                                                                   |
| `PartnerKey`        | String                                         | Unique identifier provided by partner for an object. This property is accessible only via API.                                                            |
| `PartnerProperties` | Array of [APIProperty](https://developer.salesforce.com/docs/marketing/marketing-cloud/guide/apiproperty.md) objects | A collection of metadata supplied by the client and stored by the system. These properties are accessible only via API.                                   |
| `Status`            | [SubscriberStatus](https://developer.salesforce.com/docs/marketing/marketing-cloud/guide/subscriberstatus.md) object | Defines status of a subscriber's address. Valid values include:<ul><li>Active</li><li>Bounced</li><li>Held</li><li>Unsubscribed</li><li>Deleted</li></ul> |
| `SubscriberKey`     | String                                         | Identification of a specific subscriber.                                                                                                                  |

## Related Items

- [Supported Operations for Objects and Methods](https://developer.salesforce.com/docs/marketing/marketing-cloud/guide/supported_operations_for_objects_and_methods.md)
