Part3 Developers

User emails list

GET /users/{uid}/emails

Get a user's email history

GET
/users/{uid}/emails
AuthorizationBearer <token>

In: header

Path Parameters

uid*string

Part3 user UID (Firebase Auth UID).

Query Parameters

cursor?string

Pagination cursor.

limit?string

Page size (1–100, default 25).

search?string

Free-text search by project name or activity title.

sortBy?string

Sort field. date (default), actionType, or project.

sortOrder?string

Sort direction. desc (default) or asc.

Value in"asc" | "desc"
direction?string

sent = user is the sender; received = user is the recipient. Omit for both.

Value in"sent" | "received"
filter.actionType?string

Filter by action type. Comma-separated for OR semantics. Common values: IssueDocument, ForwardDocument, ResponderResponse, ReviewerResponse, ProjectInvite.

filter.createdAt?string

Date range filter: from,to ISO dates.

filter.status?string

Filter by delivery status. Stable values: Delivered, Opened, Bounced, Failed, Sent, Pending. Comma-separated for OR.

filter.document?string

Filter by document or activity title (text search).

includeMeta?string

When true, include meta.filters with action type / status / direction enum values for UI controls.

Value in"true"

Response Body

application/json

application/json

application/json

curl -X GET "https://api.part3.io/v1/users/user_99a8b7c6d5/emails"
{
  "data": [
    {
      "mailerMessageId": "mm_8a1b2c3d4e5f60718293a4b5c6d7e8f9",
      "projectId": "proj_5f9a3c2e8b",
      "projectName": "Maple Heights Tower",
      "documentId": "doc_2a3b4c5d6e",
      "activityTitle": "RFI-014 — slab thickness",
      "actionType": "IssueDocument",
      "senderName": "Anika Patel",
      "senderEmail": "anika@example.com",
      "recipientName": "Marcus Chen",
      "recipientEmail": "marcus@example.com",
      "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,
      "createdAt": "2026-04-22T09:14:00Z"
    }
  ],
  "nextCursor": null,
  "hasMore": false,
  "meta": {}
}
{
  "error": "User not found"
}
{
  "error": "User not found"
}