---
title: "Folder Details"
method: POST
path: "/folders/details"
tags: ["Folders"]
---

# Folder Details

`POST /folders/details`

Retrieve folder metadata with optional document statistics and projections.

## Headers

- `authorization` string, nullable

## Request body

- FolderDetailsRequest — Request model for retrieving folder details with document statistics.
  - `identifiers` string[], nullable — List of folder IDs or names. If omitted, returns details for all accessible folders.
  - `include_document_count` boolean — Include total document count when true
  - `include_status_counts` boolean — Include document counts grouped by status when true
  - `include_documents` boolean — Include a paginated list of documents for each folder when true
  - `document_filters` object, nullable — Optional metadata filters applied when computing folder document statistics
  - `document_skip` integer — Number of documents to skip within each folder when include_documents is true
  - `document_limit` integer — Maximum number of documents to return per folder when include_documents is true
  - `document_fields` string[], nullable — Optional list of fields to project for folder documents (dot notation supported)
  - `sort_by` 'created_at' | 'updated_at' | 'filename' | 'external_id', nullable — Field to sort folder documents by when include_documents is true
  - `sort_direction` 'asc' | 'desc' — Sort direction for folder documents when include_documents is true

## Response `200`

Successful Response

- FolderDetailsResponse — Response wrapping folder detail entries.
  - `folders` FolderDetails[], required
    - `folder` Folder, required — Represents a folder that contains documents
      - `id` string
      - `name` string, required
      - `full_path` string, nullable
      - `parent_id` string, nullable
      - `depth` integer, nullable
      - `description` string, nullable
      - `document_ids` string[], nullable
      - `system_metadata` object
      - `summary_storage_key` string, nullable
      - `summary_version` integer, nullable
      - `summary_bucket` string, nullable
      - `summary_updated_at` string, nullable
      - `app_id` string, nullable
      - `end_user_id` string, nullable
      - `child_count` integer, nullable
    - `document_info` FolderDocumentInfo — Document summary for a folder.
      - `documents` unknown[]
        - unknown
      - `document_count` integer, nullable
      - `status_counts` object, nullable
      - `skip` integer
      - `limit` integer
      - `returned_count` integer
      - `has_more` boolean
      - `next_skip` integer, nullable

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/morphik-org/apis/fastapi.md) · [All operations](https://skmtc.net/morphik-org/apis/fastapi/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/morphik-org/fastapi/versions/2d9291c3821d/schema)