# AI Financial Research API streaming

Canonical documentation: https://veripoint.ai/api-docs/streaming

The separately licensed AI Financial Research API returns Server-Sent Events. HTTP success is separate from stream completion. Text fragments arrive in order; retain complete tool_result objects for source evidence.

| Event | Fields | Meaning |
|---|---|---|
| status | message | Progress update. |
| tool_call | tool | A data tool is about to run. |
| tool_result | tool, data, duration, is_error | One complete tool-result object. Inspect is_error. |
| generating | type | AI prose generation has started. |
| text | content | Append to the answer in arrival order. |
| suggested_actions | actions | Suggested follow-up questions. |
| done | tools_used, usage, message_id; data in data mode | Terminal event. data mode includes the collected { tool, data } results. |
| error | detail, code | The stream failed after starting. |

For the Veripoint workspace API, the terminal event is complete; for this data API it is done. A stream ending without its terminal event is incomplete.