---
title: "Get recipient engagement"
method: GET
path: "/metrics/recipients"
tags: ["Analytics"]
---

# Get recipient engagement

`GET /metrics/recipients`

Returns a paginated list of recipients with their open, click, and unsubscribe events. Use this to sync engagement data to your own database.

## Query parameters

- `email` string
- `campaignId` string
- `sequenceId` string
- `period` '1h' | '24h' | '7d' | '30d' | '90d'
- `start` string, date-time
- `end` string, date-time
- `page` integer
- `limit` integer
- `includeMachineEngagement` boolean

## Response `200`

Success

- object
  - `success` boolean
  - `recipients` object[]
    - `email` string, nullable
    - `opened` object[]
      - `campaignId` string, nullable
      - `subject` string, nullable
      - `machine` boolean
      - `engagementQuality` 'human' | 'machine' | 'asset'
      - `classificationReasons` string[]
      - `at` string, date-time
    - `clicked` object[]
      - `campaignId` string, nullable
      - `subject` string, nullable
      - `url` string, nullable
      - `machine` boolean
      - `engagementQuality` 'human' | 'machine' | 'asset'
      - `classificationReasons` string[]
      - `at` string, date-time
    - `unsubscribed` boolean
  - `pagination` Pagination
    - `page` integer
    - `limit` integer
    - `total` integer
    - `totalPages` integer

## Other responses

- `400` — Bad request
- `401` — Unauthorized
- `404` — Campaign or sequence not found

## Changes

- **2026-06-19** `fd494fa7e64d` — 7 info
  - added the new optional `query` request parameter `includeMachineEngagement`
  - added the optional property `recipients/items/clicked/items/classificationReasons` to the response with the `200` status
  - added the optional property `recipients/items/clicked/items/engagementQuality` to the response with the `200` status
  - added the optional property `recipients/items/clicked/items/machine` to the response with the `200` status
  - …3 more
- **2026-02-15** `1fb2efdbb983` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/sequenzy/apis/sequenzy-api/changes/metrics/recipients/get.md)

---

[API](https://skmtc.dev/sequenzy/apis/sequenzy-api.md) · [All operations](https://skmtc.dev/sequenzy/apis/sequenzy-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/sequenzy/sequenzy-api/revisions/d7ea66dede72/schema)