LLM Traces

List LLM request traces

Changed on

List traced LLM requests for a bank, ordered by most recent first. Requires LLM request tracing to be enabled (HINDSIGHT_API_LLM_TRACE_ENABLED). Requests older than HINDSIGHT_API_LLM_TRACE_RETENTION_DAYS are deleted; retention_days in the response says how many days are kept (null = forever).

get/v1/default/banks/{bank_id}/llm-requests

Request

Path parameters

bank_idstring required

Query parameters

statusstring nullable

Filter by status (success, error)

operationstring nullable

Filter by operation (retain, reflect, consolidation)

scopestring nullable

Filter by call scope

call_type'llm' | 'embedding' | 'rerank' | 'decision' nullable

Filter by kind of model call, told apart by scope: embedding (embedding_), rerank, decision (decision_), or llm (every other scope)

providerstring nullable

Filter by LLM provider

trace_idstring nullable

Filter to one operation run (all LLM calls sharing a trace)

document_idstring nullable

Filter to LLM calls that processed a given document

memory_idstring nullable

Filter to the operation run(s) that produced or consumed a given memory_unit

groupboolean

Paginate by operation run (trace) instead of by call; returns whole runs

start_datestring nullable

Filter from this ISO datetime (inclusive)

end_datestring nullable

Filter until this ISO datetime (exclusive)

limitinteger

Max items to return

offsetinteger

Offset for pagination

Headers

authorizationstring nullable

Response

Successful Response

bank_idstring required
totalinteger required
limitinteger required
offsetinteger required
retention_daysinteger nullable

Changes