---
title: "Query governed KB retrieval-audit logs (incl. misses/blocks/errors)"
method: GET
path: "/v1/knowledge-base/audit/retrievals"
tags: ["knowledge-base-audit"]
---

# Query governed KB retrieval-audit logs (incl. misses/blocks/errors)

`GET /v1/knowledge-base/audit/retrievals`

## Query parameters

- `start` string, date-time, required — Inclusive window start (required).
- `end` string, date-time, required — Exclusive window end (required).
- `kb_ids` string[], nullable
- `statuses` string[], nullable
- `actor_user_id` string, uuid, nullable
- `session_id` string, uuid, nullable
- `limit` integer
- `cursor` string, nullable

## Response `200`

Successful Response

- CursorPageRetrievalAuditLogSummary
  - `items` RetrievalAuditLogSummary[], required
    - `ref` string
    - `id` string, uuid, required
    - `created_at` string, date-time, required
    - `retrieval_status` string, nullable
    - `serving_decision` string, nullable
    - `audit_write_status` string, nullable
    - `requested_kb_count` integer, nullable
    - `result_count` integer, nullable
    - `response_ref_count` integer, nullable
    - `eligible_version_count` integer, nullable
    - `duration_ms` integer, nullable
    - `actor_user_id` string, uuid, nullable
    - `session_id` string, uuid, nullable
    - `agent_id` string, uuid, nullable
    - `rag_query_id` string, uuid, nullable
    - `query_hash` string, nullable
    - `query_hash_key_version` string, nullable
    - `query_length_bucket` string, nullable
    - `request_id` string, nullable
    - `trace_id` string, nullable
  - `next_cursor` string, nullable
  - `has_more` boolean, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/oneloop-hq/apis/feather-api.md) · [All operations](https://skmtc.net/oneloop-hq/apis/feather-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/oneloop-hq/feather-api/revisions/5a5597ebb2d6/schema)