Get delivery recipient activity

GET

/deliveries/{smartflowId}/{deliveryId}/recipients

Retrieve a per-contact activity list for a specific delivery. Each record represents one recipient and shows the signals they triggered (open, click, unsubscribe, spam, conversion). The signal parameter filters the list to contacts who performed the selected action; without it, all recipients are returned.

Request

Query Params

Responses

🟢200

application/json

Bodyapplication/json

🟠403

🟠404

Request Example

Shell

JavaScript

Java

Swift

curl --location '/deliveries///recipients?signal=opened&q=john&limit=100&offset=0&sort=-openedAt%2Csurname&dateFrom=2025-06-01&dateTo=2025-06-30'

Response Example

200 - Success

{
    "recipients": [
        {
            "contactId": "11ef6061-cef7-b850-ada7-c969374ebcce",
            "clientContactId": "56738",
            "firstName": "John",
            "surname": "Doe",
            "email": "john.doe@example.com",
            "deliveredAt": "2018-05-30T12:58:00+00:00",
            "openedAt": "2018-05-30T13:00:00+00:00",
            "openCount": 2,
            "clickedAt": "2018-05-30T13:01:30+00:00",
            "clickCount": 3,
            "unsubscribedAt": null,
            "spamAt": null,
            "conversionsAmount": 1287,
            "conversionsCurrency": "EUR",
            "conversionsNumber": 1
        },
        {
            "contactId": "22ef6061-cef7-b850-ada7-c969374ebcce",
            "clientContactId": "185506",
            "firstName": "Jane",
            "surname": "Smith",
            "email": "jane.smith@example.com",
            "deliveredAt": "2018-05-30T12:59:00+00:00",
            "openedAt": "2018-05-30T14:22:00+00:00",
            "openCount": 1,
            "clickedAt": null,
            "clickCount": 0,
            "unsubscribedAt": "2018-05-30T14:25:00+00:00",
            "spamAt": null,
            "conversionsAmount": null,
            "conversionsCurrency": null,
            "conversionsNumber": 0
        }
    ],
    "paging": {
        "start": 0,
        "count": 2,
        "totalCount": 412
    }
}

Modified at 2026-06-23 12:56:40

Get delivery-specific conversions

Get recipient activity timeline