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

# List all documents

`GET /documents`

Retrieve a list of documents for the authenticated team.

## Query parameters

- `cursor` string, nullable — A cursor for pagination. Pass the value returned from the previous response to get the next page.
- `sort` string[], nullable — Sort as [column, direction]. Currently documents are sorted by created date descending.
- `pageSize` number — Number of documents to return per page.
- `q` string, nullable — Search query string to filter documents by text.
- `tags` string[], nullable — Array of tag IDs to filter documents by tags.
- `start` string, nullable — Start date for filtering documents (ISO 8601 date).
- `end` string, nullable — End date for filtering documents (ISO 8601 date).

## Response `200`

Retrieve a list of documents for the authenticated team.

- object — Response containing a list of documents and pagination metadata.
  - `meta` object, required — Pagination metadata for the documents list.
    - `cursor` string, nullable — Cursor for pagination.
    - `hasPreviousPage` boolean, required — Whether there is a previous page.
    - `hasNextPage` boolean, required — Whether there is a next page.
  - `data` object[], required — Array of document objects.
    - `id` string, required — Unique identifier for the document.
    - `title` string, nullable, required — Title of the document.
    - `pathTokens` string[], required — Array of path tokens representing the document's location.
    - `metadata` object, nullable, required — Metadata about the document.
      - `size` number, nullable, required — Size of the document in bytes.
      - `mimetype` string, nullable, required — MIME type of the document.
    - `processingStatus` string, required — Processing status of the document.
    - `summary` string, nullable, required — Summary or extracted content from the document.
    - `date` string, nullable, required — Date associated with the document (ISO 8601).

## Other responses

- `default` — An error occurred

---

[API](https://skmtc.net/midday-ai/apis/midday-api.md) · [All operations](https://skmtc.net/midday-ai/apis/midday-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/midday-ai/midday-api/versions/c0df9243c1b0/schema)