Law

Overview & coverage

Building Endpoints below are specified; the index is being built. Shapes are final, parameter details may shift slightly. The playground unlocks per endpoint as each ships.

Corpus	Scale	What each record carries
Statutes	26 jurisdictions · 33,103 laws · 1,537,422 articles	Original text; zh/en translation; per-article extraction: heading, summary, norm type, subjects, conditions, consequences, key figures, references, typical questions
Chinese judgments	4,510,354 → 17,667,475	Structured brief: cause, court, level, round, date, disputed issues, facts, reasoning, decision, parties, articles (normalised), amount. Opinion and decision as sections

Jurisdictions (ISO3): CHN, JPN, GBR, USA, DEU, KOR, DNK, POL and 18 more. Chinese statutes include national laws, judicial interpretations, administrative regulations and local regulations.

Coverage & bias notice

Chinese civil judgments are ~12% indexed and the sample is not random — it follows the enrichment queue. Criminal judgments are 100%. Every Law response carries a coverage block: {"case_nature": "民事", "indexed": 1.8e6, "total": 1.44e7, "note": "…"}. Copy note into your agent’s tool description so it qualifies civil-case claims. Until enrichment completes, treat civil retrieval as indicative, not exhaustive.

Citation format — statute: [中华人民共和国刑法第266条]; case: [（2022）湘0902刑初12号]. Both resolve: law_id + article, and uuid.

Ask Lawcoming soonregistered key+ /stream

POST/legal/agent/search

Same request body as Ask arXiv, plus scope and jurisdiction. The loop calls law_search, law_read_article, law_read_chapter, case_search, case_read, law_to_cases, case_to_laws. Answers cite [中华人民共和国刑法第266条] and [（2022）湘0902刑初12号]. Response adds sources: {laws:[…], cases:[…]} and a coverage block.

CLIfa ask --domain law "…"

Parameters

Parameter	Type		Description
query	string	REQUIRED	Chinese works directly.
scope	auto \| law \| case \| both	= auto	`auto` lets the model decide: articles, precedents, or both.
jurisdiction	string	OPTIONAL	ISO3. Default auto: Chinese + Chinese-law concepts → CHN, else by the countries the query names.
effort	default \| high \| xhigh	= default	Gather rounds ceiling.
verbose	bool	= false	Include the tool-call trace.
max_answer_tokens	integer	= 4096	256–16384.
language	string	OPTIONAL	Answer language.

Example

{
  "answer": "… 法定刑为三年以下有期徒刑、拘役或者管制 [中华人民共和国刑法 第266条] … [（2022）湘0902刑初12号]",
  "sources": { "laws": [ { "law_id": "chn:law:刑法", "article": "266", "title": "…" } ],
               "cases": [ { "uuid": "…", "case_no": "（2022）湘0902刑初12号", "court": "…", "date": "2022-03-14" } ] },
  "coverage": { "case_nature": "刑事", "indexed": 2650000, "total": 2650000, "note": "刑事全量；民事仅覆盖 12%，非随机样本" },
  "stats": { "rounds": 2, "elapsed_s": 5.1, "answer_truncated": false }
}

Coverage. Civil judgments are ~12% indexed and not a random sample until enrichment completes; criminal is 100%. Put the coverage.note into your agent’s tool description.

Statutes (/law/)

Read a statute in layers: retrieve → brief → article → context → section → raw. Article 266 of the Criminal Law is ~250 characters; the whole law is ~90k.

Statutes · retrievecoming soon

GET/law/?type=retrieve&query={query}

Article-level hybrid retrieval over 1,537,422 articles from 26 jurisdictions. Returns article briefs: law, article number, heading, one-line summary, norm type, status.

Parameters

Parameter	Type		Description
query	string	REQUIRED	Natural language, any language.
jurisdiction	string[]	OPTIONAL	ISO3: CHN, JPN, GBR, USA, DEU, KOR…
law_id	string	OPTIONAL	Restrict to one law.
law_type	string	OPTIONAL	Instrument type, from `/law/facets`.
domain	string	OPTIONAL	Legal domain, from facets.
status	string	OPTIONAL	in_force / repealed / not_yet.
norm_type	string[]	OPTIONAL	Controlled vocabulary: obligation, prohibition, penalty, definition…
date_search_type	exact \| after \| before \| between	OPTIONAL	Pair with `date_str`.
date_str	string[]	OPTIONAL	`YYYY` / `YYYY-MM` / `YYYY-MM-DD`.
lang	zh \| en	OPTIONAL	Language of returned text; default original.
top_k	integer	= 10	1–100.

Statutes · briefcoming soon

GET/law/?type=brief&law_id={law_id}

One law: metadata (titles in three languages, issuer, dates, status) plus the chapter tree with a one-line summary per chapter. The head of a statute.

Parameters

Parameter	Type		Description
law_id	string	REQUIRED	Law identifier, `{country}:{subset}:{name}`, as returned by retrieve.

Statutes · articlecoming soon

GET/law/?type=article&law_id={law_id}&article={article}

One article: original text, translation, extraction (subjects, conditions, consequences, key figures), references, and how many judgments cite it.

Parameters

Parameter	Type		Description
law_id	string	REQUIRED	Law identifier, `{country}:{subset}:{name}`, as returned by retrieve.
article	string	REQUIRED	Article number.
lang	string	OPTIONAL	Comma-separated languages to include.

Example

{ "law_id": "chn:law:刑法", "article": "266", "heading_zh": "诈骗罪",
  "text": "诈骗公私财物，数额较大的，处三年以下有期徒刑、拘役或者管制，并处或者单处罚金；…",
  "text_en": "Whoever defrauds public or private property, if the amount is relatively large, …",
  "extraction": { "norm_type": ["penalty"], "subjects": ["行为人"], "conditions_zh": ["数额较大"], "consequences_zh": ["三年以下有期徒刑、拘役或者管制，并处或者单处罚金"], "key_facts": [] },
  "refs": [], "cited_by_cases": 214380 }

Statutes · contextcoming soon

GET/law/?type=context&law_id={law_id}&article={article}

The article with its neighbours and the chapter it sits in.

Parameters

Parameter	Type		Description
law_id	string	REQUIRED	Law identifier, `{country}:{subset}:{name}`, as returned by retrieve.
article	string	REQUIRED	Article number.
window	integer	= 2	Articles on each side.

Statutes · sectioncoming soon

GET/law/?type=section&law_id={law_id}&chapter={chapter}

One chapter, continuous.

Parameters

Parameter	Type		Description
law_id	string	REQUIRED	Law identifier, `{country}:{subset}:{name}`, as returned by retrieve.
chapter	string	REQUIRED	Chapter id from `brief`.

Statutes · rawcoming soon

GET/law/?type=raw&law_id={law_id}

Full text as markdown.

Parameters

Parameter	Type		Description
law_id	string	REQUIRED	Law identifier, `{country}:{subset}:{name}`, as returned by retrieve.

Statutes · cases (article → cases)coming soon

GET/law/?type=cases&law_id={law_id}&article={article}

Judgments that cite this article. Case retrieve with law_refs pre-filled; accepts the same case filters.

Parameters

Parameter	Type		Description
law_id	string	REQUIRED	Law identifier, `{country}:{subset}:{name}`, as returned by retrieve.
article	string	REQUIRED	Article number.
top_k	integer	= 10	1–100.

Cases (/case/)

China only. Read a judgment in layers: retrieve → brief (~100 tok) → head (~400) → section opinion (~600) → raw (~2k).

Cases · retrievecoming soon

GET/case/?type=retrieve&query={query}

Hybrid retrieval over Chinese judgments (China only). Returns briefs: summary, case number, court, date, cause, articles cited. Every response carries coverage.

Parameters

Parameter	Type		Description
query	string	REQUIRED	Natural language.
case_nature	刑事 \| 民事 \| 行政 \| 执行	OPTIONAL	Case nature.
cause	string[]	OPTIONAL	Cause of action, from facets.
province	string	OPTIONAL	Province.
city	string	OPTIONAL	City.
court_level	string	OPTIONAL	Court level.
trial_round	一审 \| 二审 \| 再审	OPTIONAL	Trial round.
date_search_type	exact \| after \| before \| between	OPTIONAL	Pair with `date_str`.
date_str	string[]	OPTIONAL	`YYYY` / `YYYY-MM` / `YYYY-MM-DD`.
law_refs	string[]	OPTIONAL	Cited article, `CN/刑法/266`.
amount	json	OPTIONAL	`{gte, lte}`, CNY.
sentence_months	json	OPTIONAL	`{gte, lte}`.
probation	true \| false	OPTIONAL	Probation granted.
top_k	integer	= 10	1–100.

Cases · briefcoming soon

GET/case/?type=brief&uuid={uuid}

The L1 card, ~100 tokens: cause, court, level, date, disputed issues, articles, amount, verdict.

Parameters

Parameter	Type		Description
uuid	string	REQUIRED	Judgment UUID, as returned by case retrieve.

Cases · headcoming soon

GET/case/?type=head&uuid={uuid}

Every structured field: claims, disputed issues, facts, circumstances, reasoning, decision, parties, articles, amount.

Parameters

Parameter	Type		Description
uuid	string	REQUIRED	Judgment UUID, as returned by case retrieve.

Cases · sectioncoming soon

GET/case/?type=section&uuid={uuid}§ion={section}

One section of the judgment, verbatim from the original record.

Parameters

Parameter	Type		Description
uuid	string	REQUIRED	Judgment UUID, as returned by case retrieve.
section	parties \| claims \| facts \| opinion \| decision	REQUIRED	`opinion` = 本院认为, `decision` = 判决如下.

Cases · preview / rawcoming soon

GET/case/?type=preview&uuid={uuid}

First N characters of the full judgment, or type=raw for all of it.

Parameters

Parameter	Type		Description
uuid	string	REQUIRED	Judgment UUID, as returned by case retrieve.
characters	integer	= 3000	Characters to return.

Cases · laws (case → articles)coming soon

GET/case/?type=laws&uuid={uuid}

The articles a judgment cites, resolved to article IDs, each readable via article.

Parameters

Parameter	Type		Description
uuid	string	REQUIRED	Judgment UUID, as returned by case retrieve.

Cross-links (law ↔ case)

Every judgment’s legal basis is normalised (《中华人民共和国刑法》 / 刑法 → one ID, article numbers parsed to integers) into law_refs like CN/刑法/266. That gives two exact paths: article → cases and case → articles, and a law_refs filter on case retrieve.

Law

Overview & coverage

Coverage & bias notice

Ask Lawcoming soonregistered key+ /stream

Parameters

Example

Statutes (/law/)

Statutes · retrievecoming soon

Parameters

Statutes · briefcoming soon

Parameters

Statutes · articlecoming soon

Parameters

Example

Statutes · contextcoming soon

Parameters

Statutes · sectioncoming soon

Parameters

Statutes · rawcoming soon

Parameters

Statutes · cases (article → cases)coming soon

Parameters

Statutes · facetscoming soon

Cases (/case/)

Cases · retrievecoming soon

Parameters

Cases · briefcoming soon

Parameters

Cases · headcoming soon

Parameters

Cases · sectioncoming soon

Parameters

Cases · preview / rawcoming soon

Parameters

Cases · laws (case → articles)coming soon

Parameters

Cases · facetscoming soon

Cross-links (law ↔ case)