List who opened, clicked, bounced or unsubscribed
How many people opened, clicked, bounced and unsubscribed (counts), and the first people who did one of them (event, opened by default), earliest first,…
https://app.usenotix.dev/api/v1/broadcasts/{broadcastId}/activityFull access and read only keys can call this. Sending access keys cannot. Key permissions lists the extra rules some calls have.
How many people opened, clicked, bounced and unsubscribed (counts), and the first people who did one of them (event, opened by default), earliest first, with their address, name and when they first did it. limit is 1 to 100 (50 by default). For everyone, use the export.
unsubscribed lists people this broadcast reached who then left the list through an unsubscribe link.
The team can read broadcast activity 60 times a minute.
Who can call it
Any key that reads broadcasts: full access, read only and live AI keys. A send-only key answers 403 SCOPE_DENIED. A key limited to one domain sees only broadcasts that send from its domain; any other answers 404.
Path parameters
Query parameters
Which people to list. Defaults to opened.
One of opened, clicked, bounced, unsubscribed. Default "opened".
How many people, 1 to 100. Defaults to 50.
Minimum 1. Maximum 100. Default 50.
Headers
Bearer followed by your API key.
Errors
The key is not FULL, or is limited to one domain (DOMAIN_PINNED). These show contacts and their addresses.
No campaign with this id for the calling team (or, for a key limited to one domain, on its domain).
The team read campaign activity 60 times in the last minute.
The call could not be counted just now, or the read took too long. Try again shortly.
Every error has the same shape. See all error codes.
curl -X GET "https://app.usenotix.dev/api/v1/broadcasts/<broadcastId>/activity" \
-H "Authorization: Bearer $NOTIX_API_KEY"
{
"event": "opened",
"counts": {
"opened": 1,
"clicked": 1,
"bounced": 1,
"unsubscribed": 1
},
"data": [
{
"emailId": "cm1x8f3k20001qz7v5b9d2e4a",
"email": "customer@example.com",
"firstName": "Acme",
"lastName": "Acme",
"at": "2026-10-01T09:00:00Z"
}
]
}