Document comms list
GET /organization/{orgId}/project/{projectId}/document/{documentId}/comms
List dispatches for a document
Authorization
bearer In: header
Path Parameters
Organization ID — must match the project's org.
Project ID — must contain the document.
Document ID. Returned in the uid field of any document list response (NOT the human-readable id like "RFI-014").
Query Parameters
Filter by action type. Comma-separated for OR semantics. Common values: IssueDocument, ForwardDocument, ResponderResponse, ReviewerResponse, ProjectInvite, ReportShare.
Filter by sender email address (exact match).
ISO-8601 date or date-time. Only dispatches at or after this instant are returned.
ISO-8601 date or date-time. Only dispatches at or before this instant are returned.
Sort order. recent (default) is newest dispatch first. largest ranks by total recipient count — useful for finding the highest-fanout actions.
"recent" | "largest"Cursor for the next page. Pass back nextCursor from a prior response. Opaque base64url JSON — payload differs by sort ({d,id} for recent, {n,id} for largest).
Page size, 1–50 (default 20).
Response Body
application/json
application/json
application/json
curl -X GET "https://api.part3.io/v1/organization/org_8a1b2c3d4e/project/proj_5f9a3c2e8b/document/doc_2a3b4c5d6e/comms"{
"data": [
{
"activityId": "act_12a34b5c6d",
"actionType": "IssueDocument",
"project": {
"uid": "proj_5f9a3c2e8b",
"name": "Maple Heights Tower"
},
"documentId": "doc_2a3b4c5d6e",
"reportId": null,
"sender": {
"uid": "user_99a8b7c6d5",
"name": "Anika Patel",
"email": "anika@example.com"
},
"dispatchedAt": "2026-04-22T09:14:00Z",
"recipients": [
{
"uid": "user_3b2a1c9d8e",
"name": "Marcus Chen",
"email": "marcus@example.com",
"status": "Opened",
"sentAt": "2026-04-22T09:14:01Z",
"deliveredAt": "2026-04-22T09:14:08Z",
"openedAt": "2026-04-22T11:02:33Z",
"bouncedAt": null,
"bounceType": null,
"bounceSubtype": null
}
],
"summary": {
"total": 1,
"delivered": 0,
"bounced": 0,
"opened": 1,
"pending": 0,
"failed": 0
}
}
],
"nextCursor": null,
"hasMore": false
}{
"error": "Insufficient permissions"
}{
"error": "Insufficient permissions"
}