Part3 Developers

Comms list

GET /admin/comms

List dispatches across the platform

GET
/admin/comms
AuthorizationBearer <token>

In: header

Query Parameters

actionType?string

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

sender?string

Filter by sender email address (exact match).

from?string

ISO-8601 date or date-time. Only dispatches at or after this instant are returned.

to?string

ISO-8601 date or date-time. Only dispatches at or before this instant are returned.

sort?string

Sort order. recent (default) is newest dispatch first. largest ranks by total recipient count — useful for finding the highest-fanout actions.

Value in"recent" | "largest"
cursor?string

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).

limit?string

Page size, 1–50 (default 20).

orgId?string

Filter to dispatches in one organization.

projectId?string

Filter to dispatches in one project.

documentId?string

Filter to dispatches tied to one document.

Response Body

application/json

application/json

curl -X GET "https://api.part3.io/v1/admin/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"
}