Get email campaigns' statistics for a contact

import { BrevoClient } from "@getbrevo/brevo";
async function main() {
    const client = new BrevoClient({
        apiKey: "YOUR_API_KEY_HERE",
    });
    await client.contacts.getContactStats("string", {});
}
main();

{
  "clicked": [
    {
      "campaignId": 21,
      "links": [
        {
          "count": 2,
          "eventTime": "2016-05-03T21:25:01Z",
          "ip": "66.249.93.118",
          "url": "https://url.domain.com/fbe5387ec717e333628380454f68670010b205ff/1/go?uid={EMAIL}&utm_source=brevo&utm_campaign=test_camp&utm_medium=email"
        }
      ]
    }
  ],
  "delivered": [
    {
      "campaignId": 21,
      "eventTime": "2016-05-03T21:24:56Z",
      "count": 2,
      "ip": "66.249.93.118"
    }
  ],
  "messagesSent": [
    {
      "campaignId": 21,
      "eventTime": "2016-05-03T20:15:13Z"
    },
    {
      "campaignId": 42,
      "eventTime": "2016-10-17T10:30:01Z"
    },
    {
      "campaignId": 45,
      "eventTime": "2016-11-09T11:45:02Z"
    }
  ],
  "opened": [
    {
      "campaignId": 21,
      "count": 2,
      "eventTime": "2016-05-03T21:24:56Z",
      "ip": "66.249.93.118"
    },
    {
      "campaignId": 45,
      "count": 1,
      "eventTime": "2017-01-30T13:56:40Z",
      "ip": "66.249.93.217"
    }
  ]
}

Authentication

api-keystring

The API key should be passed in the request headers as api-key for authentication.

Path parameters

identifierstring or integerRequired

Email (urlencoded) OR ID of the contact

Query parameters

startDatestringOptional

Mandatory if endDate is used. Starting date (YYYY-MM-DD) of the statistic events specific to campaigns. Must be lower than equal to endDate

endDatestringOptional

Mandatory if startDate is used. Ending date (YYYY-MM-DD) of the statistic events specific to campaigns. Must be greater than equal to startDate. Maximum difference between startDate and endDate should not be greater than 90 days

Response

Contact campaign statistics informations

clickedlist of objects

complaintslist of objects

deliveredlist of objects

hardBounceslist of objects

messagesSentlist of objects

openedlist of objects

softBounceslist of objects

transacAttributeslist of objects

unsubscriptionsobject

Errors

400

Bad Request Error

404

Not Found Error