---
title: "Retrieve Chunks V2"
method: POST
path: "/v2/retrieve/chunks"
tags: ["V2"]
---

# Retrieve Chunks V2

`POST /v2/retrieve/chunks`

## Request

- Base URL: `https://api.morphik.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.morphik.ai/v2/retrieve/chunks`
- Auth: none declared

## Headers

- `authorization` string, nullable

## Request body

- V2RetrieveRequest
  - `query` string, required
  - `filters` V2RetrieveFilters
    - `document_ids` string[], nullable: Limit to specific document IDs
    - `folder_paths` string[], nullable: Limit to specific folder paths
    - `metadata` object, nullable: Chunk-level metadata filters
  - `top_k` integer
  - `end_user_id` string, nullable: Optional end-user scope

## Response `200`

Successful Response

- V2RetrieveResponse
  - `query` string, required
  - `chunks` V2ChunkResult[], required
    - `chunk_id` string, required
    - `document_id` string, required
    - `page_number` integer, nullable
    - `chunk_number` integer, nullable
    - `score` number, required
    - `content` string, required

## Other responses

- `422`: Validation Error

## Changes

- **2026-10-16** `45d77e08d406`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/morphik-org/apis/morphik-api/changes/v2/retrieve/chunks/post.md)

---

[API](https://skmtc.dev/morphik-org/apis/morphik-api.md) - [All operations](https://skmtc.dev/morphik-org/apis/morphik-api/llms.txt) - [OpenAPI document](https://skmtc.dev/morphik-org/apis/morphik-api/revisions/45d77e08d406?raw)