---
title: "Comprehensive multi-step research"
method: POST
path: "/search/v1/research"
tags: ["Search"]
---

# Comprehensive multi-step research

`POST /search/v1/research`

Performs deep research by conducting multi-step analysis, gathering information from multiple sources, and providing comprehensive insights. Ideal for legal research, case analysis, and due diligence investigations.

## Request body

- object
  - `instructions` string, required — Research instructions or query
  - `query` string — Alias for instructions (for convenience)
  - `model` 'fast' | 'normal' | 'pro' — Research quality level - fast (quick), normal (balanced), pro (comprehensive)
  - `outputSchema` object — Optional JSON schema to structure the research output

## Response `200`

Research completed successfully

- object
  - `researchId` string — Unique identifier for this research
  - `model` string — Model used for research
  - `results` object — Research findings and analysis

## Other responses

- `400` — Invalid request - missing instructions or invalid parameters
- `401` — Invalid API key
- `403` — API key does not have access to Search service

---

[API](https://skmtc.net/casemark/apis/case-dev-api.md) · [All operations](https://skmtc.net/casemark/apis/case-dev-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/casemark/case-dev-api/revisions/5b7e64e6d6f9/schema)