---
schema_version: "1"
id: c2a1347b50ee9f5286061be933c44157cdd7ed93654b687306e864e4ceb5941e
title: ListSend
collection: developer
version: current
locale: en-us
portal_url: https://docs.salesforce.com/developer/current/en-us/marketing-cloud/guides/mc-apis/listsend.md
canonical_url: https://developer.salesforce.com/docs/marketing/marketing-cloud/guide/listsend.html
source_site: developer.salesforce.com
content_type: documentation
content_hash: d9c48e1f518d2b3976d4540f24b6a5cfca83f14775cd45da7e28a34ad90f3195
products:
  - Marketing Cloud Engagement APIs and Programmatic Languages
  - Marketing Cloud
---
# ListSend

An object that specifies retrieve-only properties associated with the list for a completed send. If you conducted the send to a data extension, ListSend represents any associated publication lists. If you conducted a send to multiple lists, a ListSend retrieve on the SendID of that send would return multiple ListSend objects.

## 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. |
| `Duplicates`             | Int                                                | Represent the number of duplicate email addresses associated with a send (exists only when a send occurs to multiple lists).              |
| `Events`                 | Array of [TrackingEvent](https://developer.salesforce.com/docs/marketing/marketing-cloud/guide/trackingevent.md) objects | Not used.                                                                                                                                 |
| `ExistingUndeliverables` | Int                                                | Indicates whether bounces occurred on previous send.                                                                                      |
| `ExistingUnsubscribes`   | Int                                                | Indicates whether unsubscriptions occurred on previous send.                                                                              |
| `ForwardedEmails`        | Int                                                | Number of emails forwarded for a send.                                                                                                    |
| `HardBounces`            | Int                                                | Indicates number of hard bounces associated with a send.                                                                                  |
| `ID`                     | Int                                                | Read-only identifier for an object. Some objects use the ObjectID property as a unique ID.                                                |
| `InvalidAddresses`       | Int                                                | Specifies the number of invalid addresses associated with a send.                                                                         |
| `Links`                  | Array of [Link](https://developer.salesforce.com/docs/marketing/marketing-cloud/guide/link.md) objects                   | Contains an array of links included in a send.                                                                                            |
| `List`                   | [List](https://developer.salesforce.com/docs/marketing/marketing-cloud/guide/list.md) object                             | List associated with an object.                                                                                                           |
| `MissingAddresses`       | Int                                                | Specifies number of missing addresses encountered within a send.                                                                          |
| `ModifiedDate`           | DateTime                                           | The date and time when the object was last modified.                                                                                      |
| `NumberDelivered`        | Int                                                | Number of sent emails that didn't bounce.                                                                                                 |
| `NumberSent`             | Int                                                | Number of emails actually sent as part of an email send. This number reflects all of the sent messages and may include bounced messages.  |
| `ObjectID`               | String                                             | System-controlled, read-only text string identifier for object.                                                                           |
| `ObjectState`            | String                                             | Not used.                                                                                                                                 |
| `OtherBounces`           | Int                                                | Specifies number of Other-type bounces in a send.                                                                                         |
| `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.                   |
| `PreviewURL`             | String                                             | Indicates URL used to preview the message associated with a send.                                                                         |
| `SendID`                 | Int                                                | Contains identifier for a specific send.                                                                                                  |
| `SoftBounces`            | Int                                                | Indicates number of soft bounces associated with a specific send.                                                                         |
| `UniqueClicks`           | Int                                                | Indicates number of unique clicks on message.                                                                                             |
| `UniqueOpens`            | Int                                                | Indicates number of unique opens resulting from a triggered send.                                                                         |
| `Unsubscribes`           | Int                                                | Indicates the number of unsubscribe events associated with a send.                                                                        |

## Related Items

- [Supported Operations for Objects and Methods](https://developer.salesforce.com/docs/marketing/marketing-cloud/guide/supported_operations_for_objects_and_methods.md)