---
title: "Deep legal research"
method: POST
path: "/legal/v1/research"
tags: ["Legal"]
---

# Deep legal research

`POST /legal/v1/research`

Perform comprehensive legal research with multiple query variations. Uses advanced deep search to find relevant sources across different phrasings of the legal issue.

## Request body

- object
  - `query` string, required — Primary search query
  - `additionalQueries` string[] — Additional query variations to search (e.g., different phrasings of the legal issue)
  - `jurisdiction` string — Optional jurisdiction ID from resolveJurisdiction
  - `numResults` integer — Number of results 1-25 (default: 10)

## Response `200`

Research completed successfully

- object
  - `query` string — Primary search query
  - `additionalQueries` string[], nullable — Additional queries used
  - `jurisdiction` string — Jurisdiction filter applied
  - `searchType` string — Search type used (deep)
  - `found` integer — Number of candidates found
  - `candidates` object[]
    - `url` string — URL of the legal source
    - `title` string — Title of the document
    - `snippet` string — Text excerpt from the document
    - `highlights` string[] — Highlighted relevant passages
    - `publishedDate` string, nullable — Publication date
    - `source` string — Domain of the source
  - `hint` string — Usage guidance

## Other responses

- `400` — Bad request - invalid query parameters
- `401` — Unauthorized - invalid API key
- `403` — Forbidden - insufficient permissions
- `503` — Service unavailable - search service unreachable

---

[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/versions/5b7e64e6d6f9/schema)