---
title: "List Documents"
method: GET
path: "/documents"
tags: ["documents"]
---

# List Documents

`GET /documents`

List all documents sorted by created_at in descending order. Results are paginated with a max limit of 100. When more documents are available, a `cursor` will be provided. Use the `cursor` parameter to retrieve the subsequent page.

## Query parameters

- `cursor` string, nullable — An opaque cursor for pagination
- `page_size` integer — The number of items per page (must be greater than 0 and less than or equal to 100)
- `filter` string, nullable — The metadata search filter. Returns only items which match the filter. The following filter operators are supported: $eq - Equal to (number, string, boolean), $ne - Not equal to (number, string, boolean), $gt - Greater than (number), $gte - Greater than or equal to (number), $lt - Less than (number), $lte - Less than or equal to (number), $in - In array (string or number), $nin - Not in array (string or number). The operators can be combined with AND and OR. Read [Metadata & Filters guide](https://docs.ragie.ai/docs/metadata-filters) for more details and examples.

## Headers

- `partition` string, nullable — An optional partition to scope the request to. If omitted, accounts created after 1/9/2025 will have the request scoped to the default partition, while older accounts will have the request scoped to all partitions. Older accounts may opt in to strict partition scoping by contacting support@ragie.ai. Older accounts using the partitions feature are strongly recommended to scope the request to a partition.

## Response `200`

Successful Response

- DocumentList
  - `pagination` Pagination, required
    - `next_cursor` string, nullable
    - `total_count` integer, required
  - `documents` Document[], required
    - `status` string, required
    - `id` string, uuid, required
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required
    - `name` string, required
    - `metadata` object, required
    - `partition` string, required
    - `chunk_count` integer, nullable
    - `external_id` string, nullable
    - `page_count` number, nullable

## Other responses

- `401` — Unauthorized
- `402` — Payment Required
- `404` — Not Found
- `422` — Validation Error
- `429` — Too Many Requests
- `500` — Internal Server Error

---

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