Flows

List Flow Run Messages

List every message attributed to a single flow run, oldest-first.

Returns the chronological transcript of outbound (Send-node) and inbound (Wait-for-reply matched) messages stamped with this flow_run_id. Reuses the existing idx_msg_flow_run_id / idx_messages_tenant_flow_run index.

404 when the run does not exist on this tenant OR when the run exists but does not belong to flow_id — never leak cross-tenant runs.

Required Scopes: flows:read AND conversations:read

get/api/v1/flows/{flow_id}/runs/{run_id}/messages

Request

  • Base URL: https://api.sendseven.com
  • URL: https://api.sendseven.com/api/v1/flows/{flow_id}/runs/{run_id}/messages
  • Auth: HTTP bearer

Path parameters

flow_idstring required
run_idstring required

Query parameters

pageinteger
page_sizeinteger

Response

Successful Response

Example response

{
  "items": [
    {
      "attachments": [],
      "channel_id": "channel-123-456-789",
      "contact_id": "contact-123-456-789",
      "conversation_id": "conv-123-456-789",
      "created_at": "2025-01-15T10:30:00Z",
      "delivered_at": "2025-01-15T10:30:05Z",
      "direction": "inbound",
      "from": "+1234567890",
      "id": "msg-123-456-789",
      "message_type": "text",
      "platform": "whatsapp",
      "status": "delivered",
      "tenant_id": "tenant-123-456-789",
      "text": "Hello, I need help!"
    }
  ]
}

Changes

No recorded changes to this operation across all 3 revisions of this API.