Part3 Developers

Emails timeline

GET /email/timeline

Get delivery timelines (batch)

GET
/email/timeline
AuthorizationBearer <token>

In: header

Query Parameters

mailerMessageIds*string

Required. Comma-separated mailer message IDs from emails_search results. Max 50 per request.

Response Body

application/json

application/json

application/json

curl -X GET "https://api.part3.io/v1/email/timeline?mailerMessageIds=mm_8a1b2c3d4e5f60718293a4b5c6d7e8f9%2Cmm_4d5e6f7a8b9c0d1e2f3a4b5c6d7e8f9"
{
  "data": [
    {
      "mailerMessageId": "mm_8a1b2c3d4e5f60718293a4b5c6d7e8f9",
      "recipientEmail": "marcus@example.com",
      "recipientName": "Marcus Chen",
      "recipientUid": "user_3b2a1c9d8e",
      "senderEmail": "anika@example.com",
      "senderName": "Anika Patel",
      "senderUid": "user_99a8b7c6d5",
      "actionType": "IssueDocument",
      "documentId": "doc_2a3b4c5d6e",
      "projectId": "proj_5f9a3c2e8b",
      "projectName": "Maple Heights Tower",
      "sentAt": "2026-04-22T09:14:01Z",
      "createdAt": "2026-04-22T09:14:00Z",
      "activityTitle": "RFI-014 — slab thickness clarification",
      "sentToMailer": "2026-04-22T09:14:00Z",
      "send": "2026-04-22T09:14:01Z",
      "delivery": "2026-04-22T09:14:08Z",
      "bounce": null,
      "bounceType": null,
      "bounceSubtype": null,
      "firstOpened": "2026-04-22T11:02:33Z",
      "lastOpened": "2026-04-22T16:45:11Z",
      "notSent": null,
      "notSentReason": null
    }
  ]
}
{
  "error": "recipient query parameter is required"
}
{
  "error": "recipient query parameter is required"
}