Transactional Email Statistics — Daily Breakdown

Overview

Retrieve transactional email statistics for a given date range. Results are returned as a daily breakdown covering delivery, engagement, bounce, and unsubscribe metrics. Base URL: https://api.effilink.co Endpoint: POST /v5/transactional/mail/stats/get Authentication: ApiKey header

Request Parameters

string

required

Start of the date range to query, in YYYY-MM-DD format. This date is inclusive.Example: "2025-05-01"

string

required

End of the date range to query, in YYYY-MM-DD format. This date is inclusive.Example: "2025-05-31"

Response Fields

int

200 on success. A non-200 value indicates an error.

string

null on success. Contains an error description on failure.

array[object]

Array of daily statistics objects covering the requested date range. Each object represents one calendar day.

Show mailStatsList[] fields

string

The calendar date for this entry in YYYY-MM-DD format.

int

Total number of emails successfully sent on this date.

int

Number of sent emails that were opened by recipients. Requires open tracking to be enabled at send time.

int

Number of link clicks recorded across all sent emails. Requires click tracking to be enabled at send time.

int

Number of soft bounces recorded — emails that were temporarily undeliverable.

int

Number of emails that were filtered or suppressed and not delivered (e.g. due to unsubscribe lists or invalid addresses).

int

Number of recipients who unsubscribed via the email’s unsubscribe link on this date.

Example

Request

curl --request POST \
  --url https://api.effilink.co/v5/transactional/mail/stats/get \
  --header 'Content-Type: application/json' \
  --header 'ApiKey: YOUR_API_KEY' \
  --data '{
    "startDate": "2025-05-01",
    "endDate": "2025-05-31"
  }'

Response

{
  "code": 200,
  "message": null,
  "mailStatsList": [
    {
      "statsDate": "2025-05-01",
      "sentCount": 450,
      "openCount": 120,
      "clickCount": 38,
      "bounceCount": 2,
      "unsentCount": 0,
      "unsubscribeCount": 1
    },
    {
      "statsDate": "2025-05-02",
      "sentCount": 510,
      "openCount": 155,
      "clickCount": 44,
      "bounceCount": 0,
      "unsentCount": 1,
      "unsubscribeCount": 2
    }
  ]
}