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

# List retrieval entries

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

## Request

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

Returns paginated retrieval entries. Each entry represents an ingested document or text. Filter by `namespace`, `content_type`, or free-text `search` on the entry ID.

Required permission: `retrieval.manage`.

## Path parameters

- `project_id` string, uuid, required

## Query parameters

- `environment_id` string, uuid, required: Environment ID from `GET /environments`.
- `namespace` string, nullable: Only entries in this namespace or its child namespaces.
- `content_type` string, nullable: Only entries of this type: `text` (text uploads and plain-text files), `pdf`, or `image`.
- `search` string, nullable: Case-insensitive match anywhere in the entry ID. `%` and `_` act as wildcards.
- `limit` integer: Maximum number of entries to return.
- `offset` integer: Number of entries to skip.
- `sort_by` 'entry' | 'chunks' | 'namespace' | 'created', nullable: Sort key: `entry` (entry ID), `chunks` (chunk count), `namespace`, or `created` (first ingestion time). Defaults to `created`.
- `sort_dir` 'asc' | 'desc', nullable: Sort direction. Defaults to `desc`.

## Response `200`

Successful Response

- PublicRetrievalEntriesResponse
  - `entries` PublicRetrievalEntryResponse[], required: Entries on this page.
    - `entry_id` string, required: Entry identifier, unique within its namespace.
    - `namespace` string, nullable, required: Namespace path. Null for the default namespace.
    - `content_type` string, nullable, required: Source type, such as `text` or `pdf`.
    - `chunk_count` integer, required: Chunks the entry was split into.
    - `page_count` integer, nullable, required: Pages in the source PDF. Null for other content types.
    - `created_at` string, date-time, nullable, required
  - `total` integer, required: Entries matching the filters across all pages.

## 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)