---
title: "V1 Suggest"
method: GET
path: "/v1/suggest"
tags: ["register"]
---

# V1 Suggest

`GET /v1/suggest`

## Request

- Base URL: `https://api.proofread.law` (the document declares no server; this is the origin it was published from)
- URL: `https://api.proofread.law/v1/suggest`
- Auth: none declared

Case suggestions. `jurisdiction` = auto (default: a Swiss statute article, or German, French or Italian text, is Swiss; anything
else is a US proposition) | ch | us.
Switzerland: statute article -> the leading cases (BGE) the Federal Supreme Court cites with it, one list in the measured order, each
row labelled with its field. `q` is an article ("Art. 41 OR", "art. 41 CO", "art 41 or") or a paragraph that cites one (federal acts
only); domain = all | civil | criminal | public | social keeps the order within that field; lang = de | fr | it | en (default: the
query's language); k = rows, 1 to 50. One resolve per answered query.
United States, BETA: `q` is a legal proposition (a sentence or a short paragraph) -> up to 3 register cases whose own text states it,
each with the passage the judgment model matched and its neighbouring paragraphs, binding cases first for `court` (a court of appeals
such as 9th Cir., a district court such as N.D. Cal., or a state for a federal court there; empty = the Supreme Court first). The answer
carries `beta: true` and the measured line. One deep-class unit per answer that ran the model; the daily model budget applies.
Paid plans and trials while the practitioner's read is pending.

## Query parameters

- `q` string
- `domain` string
- `lang` string
- `k` integer
- `court` string
- `jurisdiction` string

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/proofread/apis/proofread-law.md) · [All operations](https://skmtc.dev/proofread/apis/proofread-law/llms.txt) · [OpenAPI document](https://skmtc.dev/proofread/apis/proofread-law/revisions/32dd8702c472?raw)