# Domain Statistics (deprecated)

Retrieve a list of overall aggregated delivery and engagement statistics, grouped by recipient domain. If no query parameters are used in the path URL, only information about messages sent since 00:00 UTC on the current day will be returned.

> Note: This is a legacy endpoint. We advise using /statistics/recipient-esp to retrieve aggregated domain stats.

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

## Query parameters:

  - `CampaignID` (integer)
    Retrieves recipient domain statistics only for the specified Campaign ID.

  - `ContactsList` (integer)
    Retrieves recipient domain statistics only for the specified contact list ID.

  - `CustomCampaign` (string)
    Retrieves recipient domain statistics only for the campaign with the specified Custom Value.

  - `From` (string)
    Retrieves recipient domain statistics only for messages sent from the specified Sender Email address.

  - `FromDomain` (string)
    Retrieves recipient domain statistics only for messages sent from the specified domain.

  - `FromID` (integer)
    Retrieves recipient domain statistics only for messages sent from the sender address with the specified ID.

  - `FromTS` (string)
    Retrieves recipient domain statistics only for messages sent after the specified timestamp. Both Unix timestamp (e.g. 1514764800) and RFC3339 (2018-01-01T00:00:00) formats are accepted.

  - `FromType` (integer)
    Retrieves recipient domain statistics only for a specific type of messages:

- 1 - Transactional
- 2 - Marketing
- 3 - Unknown

  - `IsDeleted` (boolean)
    When true, will retrieve recipient domain statistics only for deleted campaigns. When false, stats for deleted campaigns will be excluded from the response.

  - `IsNewsletterTool` (boolean)
    When true, will retrieve recipient domain statistics only for campaigns created with the Legacy template builder. When false, campaigns created with the Legacy builder will be excluded from the response.

  - `IsStarred` (boolean)
    When true, will retrieve recipient domain statistics only for starred campaigns. When false, starred campaigns will be excluded from the response.

  - `MessageStatus` (integer)
    Retrieves recipient domain statistics only for messages with the specified status:

- 0 (Processed)
- 1 (Queued)
- 2 (Sent)
- 3 (Opened)
- 4 (Clicked)
- 5 (Bounce)
- 6 (Spam)
- 7 (Unsub)
- 8 (Blocked)
- 9 (SoftBounce)
- 10 (HardBounce)
- 11 (Deferred)

  - `Period` (string)
    Retrieves recipient domain statistics only for messages sent between the start of the selected period and the current timestamp.

- Day - since the start of the current day
- Week - since the start of the current week
- Month - since the start of the current month
- Year - since the start of the current year

  - `ToTS` (string)
    Retrieves recipient domain statistics only for messages sent before the specified timestamp. Both Unix timestamp (e.g. 1514764800) and RFC3339 (2018-01-01T00:00:00) formats are accepted.

## 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 registered clicks.

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

  - `Data.Domain` (string)
    The name of the recipient domain.

  - `Data.ID` (integer)
    Unique numeric ID for this domain name. Currently not returned by this endpoint.

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

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

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

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

  - `Data.UnsubscribedCount` (integer)
    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