SendStreak logo
menu

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.

Endpoint

GET https://api.sendstreak.com/v2/accounts/{accountId}/contacts/{contactId}/messages

All v2 endpoints require a bearer token - see Authentication.

Path parameters

Parameter Type Description
accountId string The account the request is scoped to.
contactId string  

Query parameters

Parameter Type Description
start integer Zero-based offset of the first item to return. Default: 0.
limit integer Maximum number of items to return. Clamped to 100. Default: 25.
search string  

Response

A page of messages (attachment bodies omitted).

{
  "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",
      "attachments": [
        {
          "filename": "hello.txt"
        }
      ]
    }
  ]
}

Errors

Status Description
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 example

curl --location --request GET 'https://api.sendstreak.com/v2/accounts/YOUR_ACCOUNT_ID/contacts/YOUR_CONTACT_ID/messages' \
--header 'Authorization: Bearer YOUR_API_TOKEN'
Try SendStreak for Free now!