import { MailChannels } from "mailchannels-sdk";

const { MAILCHANNELS_API_KEY } = process.env;
if (!MAILCHANNELS_API_KEY) throw new Error("Set MAILCHANNELS_API_KEY before running");

const mailchannels = new MailChannels(MAILCHANNELS_API_KEY);

const { data, error } = await mailchannels.metrics.engagement({
  startTime: "2026-01-01T00:00:00Z",
  endTime: "2026-01-31T23:59:59Z",
});

if (error) {
  console.error("Get engagement metrics failed:", error);
  process.exit(1);
}
console.log(data);

import os
import sys

import mailchannels

if not os.environ.get("MAILCHANNELS_API_KEY"):
    sys.exit("Set MAILCHANNELS_API_KEY before running")

# Retrieve daily open and click counts for a single campaign.
response = mailchannels.Metrics.engagement(
    start_time="2026-01-01T00:00:00Z",
    end_time="2026-01-31T23:59:59Z",
    campaign_id="newsletter_jan_2026",
    interval="day",
)

print(response)

<?php

require_once __DIR__ . '/vendor/autoload.php';

use MailChannels\Client;

$api_key = getenv('MAILCHANNELS_API_KEY') or exit("Error: MAILCHANNELS_API_KEY is not set\n");

$client = new Client(apiKey: $api_key);

// Retrieve daily open and click counts for a single campaign.
$response = $client->metrics->engagement(
    startTime:  '2026-01-01T00:00:00Z',
    endTime:    '2026-01-31T23:59:59Z',
    campaignId: 'newsletter_jan_2026',
    interval:   'day',
);

print_r($response->toArray());

curl --request GET \
  --url https://api.mailchannels.net/tx/v1/metrics/engagement \
  --header 'X-Api-Key: <x-api-key>'

{
  "buckets": {
    "click": [
      {
        "count": 1,
        "period_start": "2023-11-07T05:31:56Z"
      }
    ],
    "click_tracking_delivered": [
      {
        "count": 1,
        "period_start": "2023-11-07T05:31:56Z"
      }
    ],
    "open": [
      {
        "count": 1,
        "period_start": "2023-11-07T05:31:56Z"
      }
    ],
    "open_tracking_delivered": [
      {
        "count": 1,
        "period_start": "2023-11-07T05:31:56Z"
      }
    ],
    "unique_click": [
      {
        "count": 1,
        "period_start": "2023-11-07T05:31:56Z"
      }
    ],
    "unique_click_tracking_delivered": [
      {
        "count": 1,
        "period_start": "2023-11-07T05:31:56Z"
      }
    ],
    "unique_open": [
      {
        "count": 1,
        "period_start": "2023-11-07T05:31:56Z"
      }
    ],
    "unique_open_tracking_delivered": [
      {
        "count": 1,
        "period_start": "2023-11-07T05:31:56Z"
      }
    ]
  },
  "click": 1,
  "click_tracking_delivered": 1,
  "open": 1,
  "open_tracking_delivered": 1,
  "end_time": "2023-11-07T05:31:56Z",
  "start_time": "2023-11-07T05:31:56Z",
  "unique_click": 1,
  "unique_click_tracking_delivered": 1,
  "unique_open": 1,
  "unique_open_tracking_delivered": 1
}

{
  "errors": [
    "<string>"
  ]
}