---
title: "Get retrieval stats"
method: GET
path: "/v1/projects/{project_id}/retrieval/stats"
tags: ["retrieval"]
---

# Get retrieval stats

`GET /v1/projects/{project_id}/retrieval/stats`

## Request

- Base URL: `https://api.connic.co`
- URL: `https://api.connic.co/v1/projects/{project_id}/retrieval/stats`
- Auth: HTTP bearer

Return entry and chunk totals for an environment, with chunk counts per namespace and entry counts per content type.

Required permission: `retrieval.manage`.

## Path parameters

- `project_id` string, uuid, required

## Query parameters

- `environment_id` string, uuid, required: Environment ID from `GET /environments`.

## Response `200`

Successful Response

- PublicRetrievalStatsResponse
  - `total_entries` integer, required: Entries across all namespaces.
  - `total_chunks` integer, required: Chunks across all namespaces.
  - `namespaces` PublicRetrievalStatsNamespaceResponse[], required: Named namespaces with their chunk counts. The default namespace is not listed.
    - `name` string, required: Full dot-separated namespace path.
    - `chunk_count` integer, required: Chunks stored directly in this namespace.
  - `content_types` object, required: Number of entries per content type.

## Other responses

- `401`: Missing or invalid API key.
- `403`: The API key lacks the required permission or access to the environment.
- `422`: Validation Error
- `429`: Rate limit exceeded.

---

[API](https://skmtc.dev/connic/apis/connic-api.md) · [All operations](https://skmtc.dev/connic/apis/connic-api/llms.txt) · [OpenAPI document](https://skmtc.dev/connic/apis/connic-api/revisions/482932da5fbe?raw)