# User Agent Statistics

Retrieve a list of open or click statistics, grouped by web browser or email client.

> Note: If no query parameters are used, will return stats with FromTS equal to the current day at 00:00 UTC.

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

## Query parameters:

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

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

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

  - `Event` (string)
    Type of event you want the count for.

Possible values:

- open
- click

Default value: click

  - `ExcludePlatform` (string)
    Exclude browsers / email clients running on this platform from response.

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

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

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

  - `FromTS` (string)
    Retrieves 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 statistics only for a specific type of messages:

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

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

  - `IsNewsletterTool` (boolean)
    When true, will retrieve 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 statistics only for starred campaigns. When false, starred campaigns will be excluded from the response.

  - `Period` (string)
    Retrieves 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

  - `Platform` (string)
    Retrieves statistics only for the specified platform.

  - `ToTS` (string)
    Retrieves 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.Count` (integer)
    Number of clicks using this browser / email client.

  - `Data.DistinctCount` (integer)
    User of messages clicked using this browser / email client.

  - `Data.Platform` (string)
    Platform on which the browser / email client runs.

  - `Data.UserAgent` (string)
    Description of the user agent.

  - `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