List knowledge base retrievals

See every knowledge base lookup an agent made during a call, with the query and the chunks it got back.

GEThttps://api.tried.com.au/kb-retrievals/{call_id}

Beyond Retell Returns the knowledge base lookups logged for one call, oldest first. Use it to debug why an agent gave an answer: you see what it searched for, how the query was rewritten, and which chunks it received.

A row is logged each time the voice agent searches its knowledge bases during the call. The call object also links to this data through knowledge_base_retrieved_contents_url.

Request#

Path parameter	Type	Required	Description
`call_id`	string	Yes	The call ID, starting with `call_`.

Example request#

curl https://api.tried.com.au/kb-retrievals/call_c837e1e2d9691e32ae3bbd47 \
  -H "Authorization: Bearer $TRIED_API_KEY"

const res = await fetch("https://api.tried.com.au/kb-retrievals/call_c837e1e2d9691e32ae3bbd47", {
  headers: { Authorization: `Bearer ${process.env.TRIED_API_KEY}` },
});
const retrievals = await res.json();

import os, requests

res = requests.get(
    "https://api.tried.com.au/kb-retrievals/call_c837e1e2d9691e32ae3bbd47",
    headers={"Authorization": f"Bearer {os.environ['TRIED_API_KEY']}"},
)
retrievals = res.json()

Response#

200 OK

[
  {
    "retrieval_id": "kbr_779083e946c98b72a5dbed95",
    "call_id": "call_c837e1e2d9691e32ae3bbd47",
    "query": "what about Saturday?",
    "rewritten_query": "Are you open on Saturday? what about Saturday?",
    "chunks": [
      {
        "text": "We are open 8am to 6pm, Monday to Saturday.",
        "score": 0.8123,
        "source_title": "Opening hours",
        "knowledge_base_id": "knowledge_base_9f060d81a4d8df9b04ca6d12"
      }
    ],
    "created_timestamp": 1760832061532
  }
]

Field	Type	Description
`retrieval_id`	string	Starts with `kbr_`.
`query`	string	The query the agent sent.
`rewritten_query`	string or null	The standalone query Tried built from the recent turns and the KB instruction. `null` when the query was not rewritten.
`chunks`	array	Chunks returned, best first.
`chunks[].text`	string	Chunk text.
`chunks[].score`	number	Cosine similarity, rounded to 4 decimals.
`chunks[].source_title`	string	Title of the source the chunk came from.
`chunks[].knowledge_base_id`	string	Knowledge base the chunk came from.
`created_timestamp`	integer	Unix ms when the lookup ran.

A call with no lookups, or a call ID that is not in your workspace, returns an empty array.

Errors#

Status	When
`401`	Missing or invalid API key.
`403`	The key's IP allowlist or scopes reject the request. This route needs the `calls` scope.
`429`	Rate limit exceeded. See Rate limits.

See Errors for the body format.