List received messages
List the messages your inboxes received, newest first.
https://app.usenotix.dev/api/v1/inbound/messagesFull access and read only keys can call this. Sending access keys cannot. Key permissions lists the extra rules some calls have.
List the messages your inboxes received, newest first. Messages caught as spam are left out. Pass nextCursor back as cursor for the next page; limit is 1 to 100 (25 by default), and inbox narrows the list to one inbox. Every message is also sent to your webhooks as email.received. 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
Minimum 1. Maximum 100. Default 25.
Only messages received by this inbox.
Headers
Bearer followed by your API key.
Errors
Invalid limit or cursor.
`FORBIDDEN`: the key's creator has left the team.
Every error has the same shape. See all error codes.
curl -X GET "https://app.usenotix.dev/api/v1/inbound/messages" \
-H "Authorization: Bearer $NOTIX_API_KEY"
{
"data": [
{
"messageId": "cm1x8f3k20001qz7v5b9d2e4a",
"conversationId": "cm1x8f3k20001qz7v5b9d2e4a",
"inbox": {
"id": null,
"name": null
},
"from": "Chiamaka Obi <chiamaka@gmail.com>",
"to": [
null
],
"cc": [
null
],
"subject": "Your receipt for order 4471",
"text": "Thanks for your order.",
"html": "<p>Thanks for your order.</p>",
"strippedText": "Thanks for your order.",
"attachments": [
null
],
"contactId": "cm1x8f3k20001qz7v5b9d2e4a",
"inReplyToEmailId": "cm1x8f3k20001qz7v5b9d2e4a",
"spamVerdict": "string",
"dmarcVerdict": "PASS",
"senderVerified": true,
"receivedAt": "2026-10-01T09:00:00Z"
}
],
"nextCursor": "string"
}