---
title: "Search Documents"
method: POST
path: "/search/documents"
tags: ["data"]
---

# Search Documents

`POST /search/documents`

Search public source documents using the same bounded service as MCP.

## Request body

- DocumentSearchRequest
  - `query` string, required — Natural-language search query.
  - `limit` integer — Maximum source-document matches.
  - `ticker` string, nullable — Optional company ticker filter.
  - `form` string, nullable — Optional filing form filter, such as 10-K or 10-Q.
  - `fiscal_year` integer, nullable — Optional fiscal year filter.
  - `date_from` string, nullable — Inclusive ISO date lower bound.
  - `date_to` string, nullable — Exclusive ISO date upper bound.

## Response `200`

Successful Response

- DocumentSearchResult
  - `text` string, required — Formatted, citation-ready source-document matches.

## Other responses

- `422` — Validation Error

---

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