Summarise received mail
Counts of what your inboxes received over the last days (7 by default, at most 90): messages, unverified senders, automatic replies and messages that…
https://app.usenotix.dev/api/v1/inbound/summaryFull access and read only keys can call this. Sending access keys cannot. Key permissions lists the extra rules some calls have.
Counts of what your inboxes received over the last days (7 by default, at most 90): messages, unverified senders, automatic replies and messages that read like an unsubscribe request; conversations by status; messages per inbox; replies per campaign; and the 10 latest conversations with a short preview. campaignId narrows everything to replies to one campaign. Every figure is counted from stored mail; nothing is estimated. Spam is left out. A key made by a team member reads only the mail of the inboxes that member belongs to; a key made by an admin or the owner, every inbox; a key made before Notix recorded who made each key, the whole team's, as before. A key whose creator left the team answers 403 FORBIDDEN.
Query parameters
How many days back to count, 1 to 90. Defaults to 7.
Minimum 1. Maximum 90. Default 7.
Only replies to this campaign's emails.
Headers
Bearer followed by your API key.
Errors
Invalid days or campaignId.
campaignId does not name a campaign of the calling team.
Another reply summary for this team is still running.
Reply summaries are briefly unavailable.
Every error has the same shape. See all error codes.
curl -X GET "https://app.usenotix.dev/api/v1/inbound/summary" \
-H "Authorization: Bearer $NOTIX_API_KEY"
{
"window": {
"days": 1,
"since": "2026-10-01T09:00:00Z"
},
"received": {
"messages": 1,
"unverifiedSenders": 1,
"autoReplies": 1,
"unsubscribeRequests": 1
},
"conversations": {
"open": 1,
"pending": 1,
"closed": 1,
"waitingForReply": 1
},
"byInbox": [
{
"inboxId": "cm1x8f3k20001qz7v5b9d2e4a",
"inboxName": "Acme",
"messages": 1
}
],
"byCampaign": [
{
"campaignId": "cm1x8f3k20001qz7v5b9d2e4a",
"campaignName": "Acme",
"replies": 1
}
],
"recent": [
{
"conversationId": "cm1x8f3k20001qz7v5b9d2e4a",
"status": "string",
"lastMessageAt": "2026-10-01T09:00:00Z",
"customerEmail": "customer@example.com",
"subject": "Your receipt for order 4471",
"preview": "string",
"senderVerified": true
}
]
}