---
title: "List Ingested Documents"
method: GET
path: "/v1/artifacts/list"
tags: ["artifacts"]
---

# List Ingested Documents

`GET /v1/artifacts/list`

Retrieve a list of all documents ingested into a specific collection

## Query parameters

- `collection` string, required

## Response `200`

Successfully retrieved document list

- IngestResponse — Response model for successful document ingestion operations.
  - `object` 'list' — Response object type, always 'list' for ingestion responses
  - `model` 'private-gpt' — Model identifier, always 'private-gpt'
  - `data` IngestedDoc[], required — List of ingested documents with their metadata and processing information
    - `object` 'ingest.document' — Type of the object, indicating this is an ingested document.
    - `artifact` string, required — Unique identifier for the ingested document artifact.
    - `doc_metadata` object, nullable — Metadata associated with the ingested document, such as title, author, and other

## Other responses

- `401` — Unauthorized

---

[API](https://skmtc.dev/privategpt/apis/api-reference.md) · [All operations](https://skmtc.dev/privategpt/apis/api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/privategpt/api-reference/revisions/15d9ccfd68da/schema)