Skip to main content
GET
cURL

Authorizations

Authorization
string
header
required

Timbal API key. Obtain your API key from the Timbal platform settings. See Authentication for more information.

Path Parameters

org_id
string
required
project_id
string
required
env_id
string
required
eval_run_id
string
required

Query Parameters

after
integer<int64>

Last seen seq (exclusive). Default 0 = from the start.

Required range: x >= 0
limit
integer | null

Max events per response (clamped to 1..=2000). Default 500.

Required range: x >= 0
wait_ms
integer<int64> | null

Long-poll timeout in ms (clamped to 0..=30000). Default 0 (return immediately). When >0 and nothing is available past after, the request blocks until a new event arrives, the run completes, or the timeout elapses.

Required range: x >= 0

Response

Event batch

done
boolean
required

true once the run has finished and all buffered events up to the terminal one have been returned.

eval_run_id
string
required
events
object[]
required
expired
boolean
required

true when the run's in-memory buffer is no longer available (dropped on completion, never existed on this instance, or the owning process died). Terminal but possibly incomplete — do not treat as a clean end-of-stream; re-fetch GET …/evals/runs/{id} for status + the full results.

next_cursor
integer<int64>
required

Pass as after on the next poll. Equals the last returned seq, or the request's after when the batch is empty.

Required range: x >= 0