# List Statistics (deprecated)

Retrieve a list of overall aggregated delivery and engagement statistics, as well as general details and subscriber counts for all contact lists.

> Note: This is a legacy endpoint. We advise using /statcounters to retrieve aggregated statistics for contact lists.

Endpoint: GET /v3/REST/liststatistics
Version: 1.0.0
Security: basicAuth

## Query parameters:

  - `Address` (string)
    Retrieves statistics only for the contact list linked to the specified email address generated by Mailjet.

  - `CalcExcludedSubscriber` (boolean)
    When true, will return the number of list members that are excluded from campaigns in ExcludedSubscriberCount.

Default value: false

  - `ContactsListID` (integer)
    Retrieves statistics only for the specified contact list ID.

  - `ExcludeID` (integer)
    Unique numeric ID for this object.

## Response 200 fields (application/json):

  - `Count` (integer)
    Indicates the number of objects in the Data array.

  - `Data` (array)
    A JSON array containing a list of objects returned by this endpoint.

  - `Data.BlockedCount` (integer)
    Number of blocked messages.

  - `Data.BouncedCount` (integer)
    Number of bounced messages.

  - `Data.ClickedCount` (integer)
    Number of clicked messages.

  - `Data.CreatedAt` (string)
    Timestamp indicating when the contact list was created.

  - `Data.DeferredCount` (integer)
    Number of deferred messages - ones that could not be delivered and the system is retrying to send. If after 3 days the sending is unsuccessful, those messages become soft-bounced.

  - `Data.DeliveredCount` (integer)
    Number of messages delivered to their destination.

  - `Data.ExcludedSubscriberCount` (integer)
    Number of list members that have been excluded from campaigns. Only calculated when CalcExcludedSubscriber is specified as True in the query.

  - `Data.HardbouncedCount` (integer)
    Number of hard-bounced messages.

  - `Data.ID` (integer)
    Unique numeric ID assigned to this contact list.

  - `Data.IsDeleted` (boolean)
    Indicates whether this list is deleted or not.

  - `Data.LastActivityAt` (string)
    Timestamp indicating the last registered activity for this contact list.

  - `Data.Name` (string)
    User-specified name for this contact list (must be unique).

  - `Data.OpenedCount` (integer)
    Number of opened messages.

  - `Data.PreQueuedCount` (integer)
    Number of pre-queued messages.

  - `Data.ProcessedCount` (integer)
    Number of processed messages.

  - `Data.QueuedCount` (integer)
    Number of queued messages.

  - `Data.SoftbouncedCount` (integer)
    Number of soft-bounced messages.

  - `Data.SpamComplaintCount` (integer)
    Number of messages marked as Spam by the recipients.

  - `Data.SubscriberCount` (integer)
    Number of subscribers.

  - `Data.UnsubscribedCount` (integer)
    Number of contacts registered in this contact list. Includes contacts that were unsubscribed from the list, as well as ones that are excluded from campaigns.

  - `Data.WorkFlowExitedCount` (integer)
    Number of registered automation workflow exits.

  - `Data.ActiveCount` (integer)
    Deprecated - Number of active list members.

  - `Data.ActiveExcludedSubscriberCount` (integer)
    Deprecated - Total number of active contacts excluded from campaigns.

  - `Data.ActiveUnsubscribedCount` (integer)
    Deprecated - Number of registered unsubscribe requests.

  - `Total` (integer)
    Indicates the number of objects in the Data array.


## Response 400 fields

## Response 401 fields

## Response 403 fields

## Response 404 fields

## Response 429 fields

## Response 500 fields