---
title: "Retrieve documents based on a query"
method: POST
path: "/v1/retrieve"
---

# Retrieve documents based on a query

`POST /v1/retrieve`

## Request body

- object
  - `query` string, required — The query string to retrieve documents.

## Response `200`

Successful retrieval of documents

- object
  - `passages` object[]
    - `doc_id` string — The unique identifier for the document.
    - `content` string — The content of the retrieved document.
    - `score` number, float — The score of the retrieved document.

## Other responses

- `400` — Invalid request due to missing query parameter

## Changes

- **2024-11-18** `19765fce26c8` — 1 info
  - endpoint added
- **2024-10-08** `d3e705544181` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/marker-inc-korea/apis/example-api/changes/v1/retrieve/post.md)

---

[API](https://skmtc.dev/marker-inc-korea/apis/example-api.md) · [All operations](https://skmtc.dev/marker-inc-korea/apis/example-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/marker-inc-korea/example-api/revisions/19765fce26c8/schema)