---
title: "Get one retrieval-audit log with its scopes and chunk refs"
method: GET
path: "/v1/knowledge-base/audit/retrievals/{ref}"
tags: ["knowledge-base-audit"]
---

# Get one retrieval-audit log with its scopes and chunk refs

`GET /v1/knowledge-base/audit/retrievals/{ref}`

## Path parameters

- `ref` string, required

## Response `200`

Successful Response

- RetrievalAuditDetailResponse — A retrieval log plus its scopes (incl. misses/blocks) and chunk refs.
  - `log` RetrievalAuditLogDetail, required — Detail view — adds policy/config/error context (still hashes/ids only).
    - `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
    - `caller` string, nullable
    - `initiator_type` string, nullable
    - `principal_type` string, nullable
    - `permission` string, nullable
    - `permission_decision` string, nullable
    - `query_hash_scope` string, nullable
    - `query_length` integer, nullable
    - `eligible_version_digest` string, nullable
    - `ineligible_counts_by_reason` object, nullable
    - `policy_version` string, nullable
    - `eligibility_rule_version` string, nullable
    - `scan_policy_version` string, nullable
    - `scan_policy_decision` string, nullable
    - `retrieval_config_version` string, nullable
    - `embedding_model` string, nullable
    - `reranker_model` string, nullable
    - `top_k` integer, nullable
    - `effective_limit` integer, nullable
    - `ranking_mode` string, nullable
    - `alpha` number, nullable
    - `reranked` boolean, nullable
    - `error_code` string, nullable
    - `error_category` string, nullable
    - `intent_recorded_at` string, date-time, nullable
    - `finalized_at` string, date-time, nullable
  - `scopes` RetrievalAuditScopeView[], required
    - `knowledge_base_id` string, uuid, nullable
    - `requested` boolean, nullable
    - `eligible_version_count` integer, nullable
    - `result_count` integer, nullable
    - `serving_decision` string, nullable
    - `scan_policy_decision` string, nullable
    - `effective_serving_status_counts` object, nullable
  - `refs` RetrievalAuditRefView[], required
    - `knowledge_base_id` string, uuid, nullable
    - `document_id` string, uuid, nullable
    - `document_version_id` string, uuid, nullable
    - `chunk_id` string, uuid, nullable
    - `chunk_index` integer, nullable
    - `chunk_stable_id` string, nullable
    - `chunk_content_hash` string, nullable
    - `chunk_content_hash_key_version` string, nullable
    - `document_version_content_hash` string, nullable
    - `citation_ref` string, nullable
    - `source_uri_hash` string, nullable
    - `rank` integer, nullable
    - `score` number, nullable

## Other responses

- `400` — Bad request
- `401` — Authentication required
- `404` — Resource not found
- `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)