List messages sent to a contact
Lists a contact’s full send history - transactional, automation, and campaign emails - as a paginated envelope. Attachment bodies are stripped to filenames; fetch them via the attachments endpoint.
GET
/v2/ accounts/ {accountId}/ contacts/ {contactId}/ messagesPath parameters
accountIdstringrequired
The account the request is scoped to.
contactIdstringrequired
Query parameters
startintegeroptional
Zero-based offset of the first item to return. Default: 0.
limitintegeroptional
Maximum number of items to return. Clamped to 100. Default: 25.
searchstringoptional
Response
A page of messages (attachment bodies omitted).
Errors
401
Missing or invalid token, or the token is not authorized for this account/user.
404
The requested resource does not exist.
See Errors and rate limits for what error responses look like.
curl --location --request GET 'https://api.sendstreak.com/v2/accounts/YOUR_ACCOUNT_ID/contacts/YOUR_CONTACT_ID/messages' \
--header 'Authorization: Bearer YOUR_API_TOKEN'
const res = await fetch('https://api.sendstreak.com/v2/accounts/YOUR_ACCOUNT_ID/contacts/YOUR_CONTACT_ID/messages', {
method: 'GET',
headers: {
Authorization: `Bearer ${process.env.SENDSTREAK_TOKEN}`
}
});
import os, requests
res = requests.get(
'https://api.sendstreak.com/v2/accounts/YOUR_ACCOUNT_ID/contacts/YOUR_CONTACT_ID/messages',
headers={'Authorization': f"Bearer {os.environ['SENDSTREAK_TOKEN']}"},
)
{
"start": 0,
"limit": 25,
"items": [
{
"_id": "665f0a2b1c9d440012ab34cd",
"rcpt": "[email protected]",
"subject": "Welcome to Acme!",
"status": "queued",
"templateSlug": "sign-up-thank-you",
"parentType": "automation",
"createDate": "2026-07-07T09:30:00.000Z",
"rcptName": "Vera Nagy",
"fromName": "Acme Team",
"fromEmail": "[email protected]",
"statusDetails": "Recipient has hard bounced",
"content": "<h1>Welcome to Acme!</h1><p>Your account is ready.</p>",
"textContent": "Welcome to Acme! Your account is ready.",
"sentFromEmail": "[email protected]",
"sentFromName": "Acme Support",
"sentViaMailServer": "6652ee3f5a0c220015bc34de",
"attachments": [
{
"filename": "hello.txt"
}
]
}
]
}