Judicial Case Search - Keyword — get_case_list
Keyword case search (including full element breakdown)
- Selected price
- $0.05 / callPublished pricing
- Providers / implementations
- 1 / 1
- Requests · 30d
- —Loading...
- Success rate · 30d
- —Loading...
| Provider | Price / call | Requests · 30d | Performance | Access |
|---|---|---|---|---|
pkulawCurrent Judicial Case Search - Keyword — get_case_list · POST | $0.05 / call | — | —successP50— |
Loading...
Statistics use persisted gateway logs from the last 30 days up to now, including today.
Success rate = successful requests / all requests;
P50 = median latency of successful requests.
Prices reflect the published API contract. Contract revision: 3. Price update time: not supplied.
Playground
Run sends a real API request. Charges follow the published API contract.
Request example
curl \
'https://api.openany.si/v1/agent-apis/pkulaw/case-keyword/get_case_list' \
-X POST \
-H "Authorization: Bearer $OPENANY_API_KEY" \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
--data-raw '{
"caseClassName": "民事",
"caseGrade": [
"指导性案例",
"参考案例"
],
"court": "最高人民法院",
"documentAttr": [
"判决书",
"裁定书"
],
"endLastInstanceDate": "2026.7.1",
"fulltext": "合同纠纷",
"pageSize": 3,
"startLastInstanceDate": "2025.1.1",
"title": "纠纷"
}'- Method
- POST
- Endpoint
https://api.openany.si/v1/agent-apis/pkulaw/case-keyword/get_case_list- Content type
- application/json
- Authentication
Authorization: Bearer $OPENANY_API_KEY
Request example
curl \
'https://api.openany.si/v1/agent-apis/pkulaw/case-keyword/get_case_list' \
-X POST \
-H "Authorization: Bearer $OPENANY_API_KEY" \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
--data-raw '{
"caseClassName": "民事",
"caseGrade": [
"指导性案例",
"参考案例"
],
"court": "最高人民法院",
"documentAttr": [
"判决书",
"裁定书"
],
"endLastInstanceDate": "2026.7.1",
"fulltext": "合同纠纷",
"pageSize": 3,
"startLastInstanceDate": "2025.1.1",
"title": "纠纷"
}'Input parameters
Fields in this listing; additional options and input encoding can vary by provider.
| Parameter | Location | Type | Required | Description |
|---|---|---|---|---|
accusation | JSON request bodybody | string | No | Offense of conviction, e.g. `危险驾驶罪` (dangerous driving). Can be searched on its own. An unrecognized value causes an error rather than silently dropping this condition. maxLength: 50 |
caseClassName | JSON request bodybody | string | No | Case type name, matched by name containment, e.g. `民事一审` (civil first instance). `民事` (civil) alone includes both civil first-instance and civil second-instance cases. maxLength: 20 |
caseFlag | JSON request bodybody | string | No | Case number, matched as a complete phrase, e.g. `（2020）京01民终1234号`. maxLength: 80 |
caseGrade | JSON request bodybody | array | No | Reference levels, at most 4, combined with OR, e.g. ["指导性案例"] (guiding cases). Do not supply names of sublevels. maxItems: 4 Nested fields and variants
|
category | JSON request bodybody | array | No | Causes of action, at most 5, combined with OR, e.g. ["租赁合同纠纷"] (lease contract disputes). When reusing a returned path as input, pass only the final level. maxItems: 5 Nested fields and variants
|
court | JSON request bodybody | string | No | Name of a specific court, e.g. `北京市朝阳区人民法院` (Chaoyang District People's Court of Beijing). `最高人民法院` searches that specific court, the Supreme People's Court. Do not enter a court level such as `中级人民法院` (intermediate people's court); use courtLevel for that. maxLength: 40 |
courtLevel | JSON request bodybody | string | null | No | Court level, e.g. `中级人民法院` (intermediate people's court). If omitted, no restriction applies. |
cursor | JSON request bodybody | string | No | Pass back nextCursor from the previous page unchanged. For example, an empty string denotes the first page. Do not supply it unless the user requests more results. Keep filters, sorting, and pageSize the same as on the previous page. maxLength: 512 |
documentAttr | JSON request bodybody | array | No | Document types, at most 3, combined with OR, e.g. ["判决书"] (judgments). Cannot be the sole condition. maxItems: 3 Nested fields and variants
|
endLastInstanceDate | JSON request bodybody | string | No | Case conclusion date to, inclusive, e.g. `2024.12.31` or `2024-12-31`. maxLength: 10 |
finalResult | JSON request bodybody | string | null | No | Final-instance outcome; supply only one, e.g. `维持原判` (original judgment upheld). Cannot be the sole condition. |
fulltext | JSON request bodybody | string | No | Full-text keywords, e.g. `押金` (deposit). Spaces and commas mean AND; | means OR. Returns matching excerpts only, not the document's full text. maxLength: 40 |
gist | JSON request bodybody | string | No | Keywords in key adjudication points, matched as contiguous phrases, e.g. `违约金` (liquidated damages). Spaces and commas mean AND; | means OR. maxLength: 40 |
judge | JSON request bodybody | string | No | Name of the hearing judge, matched as a contiguous phrase, e.g. `王某` (Wang, anonymized). Cannot be the sole condition. maxLength: 40 |
pageSize | JSON request bodybody | integer | No | Number of results on this page, e.g. 10; maximum 50. A search can retrieve at most 50 results across 5 pages. Keep this value the same as on the previous page when paginating. minimum: 1 · maximum: 50 |
party | JSON request bodybody | string | No | Party names, matched as contiguous phrases, e.g. `张某` (Zhang, anonymized). Spaces and commas mean AND; | means OR. maxLength: 40 |
penalty | JSON request bodybody | array | No | Sentencing categories, at most 3, combined with OR, e.g. ["三年以下"] (three years or less). Terms with subcategories include those subcategories in the search. `缓刑` (suspended sentence) is not available. Cannot be the sole condition. maxItems: 3 Nested fields and variants
|
procedure | JSON request bodybody | string | null | No | Procedure; supply only one, e.g. `二审` (second instance). To retrieve first-instance or second-instance cases, make two calls. |
sort | JSON request bodybody | string | No | Sort order, e.g. relevance. Use judgmentDateDesc for newest first or judgmentDateAsc for oldest first. enum: "relevance", "judgmentDateDesc", "judgmentDateAsc" |
startLastInstanceDate | JSON request bodybody | string | No | Case conclusion date from, inclusive, e.g. `2024.1.1` or `2024-01-01`. maxLength: 10 |
subjectAmount | JSON request bodybody | array | No | Amount-in-dispute bands, at most 3, combined with OR, e.g. ["100-500万"] (1-5 million yuan). Amounts are in yuan; 0 yuan is excluded. Cannot be the sole condition. maxItems: 3 Nested fields and variants
|
title | JSON request bodybody | string | No | Title keywords, e.g. `房屋租赁合同` (residential lease contract). Spaces and commas mean AND; | means OR. The Chinese enumeration comma does not split terms. maxLength: 120 |
Required markers inside a nested object or variant apply when that object or variant is used.
Sample response
Published response example · Documented HTTP 200; not a live result. Published documentation example. Verify the actual response after an approved call.
Documentation example
{
"_meta": {
"io.modelcontextprotocol/serverInfo": {
"name": "mcp-case",
"title": "北大法宝·案例关键词检索",
"version": "2.0.0"
},
"pkulaw/evidence": {
"confidence": "B",
"notes": [],
"origin": "catalog",
"retrievedAt": "2026-10-28T12:43:21Z",
"verifiedByApi": true
},
"pkulaw/limits": [
"还有下一页。用户没有要求更多时停在本页。要继续只把 nextCursor 原样传回 cursor，筛选、排序和 pageSize 不要改。最多 5 页，一次最多 50 条。"
]
},
"content": [
{
"text": "命中 7，本页 3 条，第 1 页，最多 5 页，一次最多 50 条。用户没有要求更多时停在本页。要继续把 nextCursor 原样传回 cursor，筛选、排序和 pageSize 不要改。本页法院集中在 最高人民法院。要看其他法院请改 court 或 courtLevel 后重新检索，只翻页仍会堆在同一排序里。\n- [(2025)最高法民辖35号](https://www.pkulaw.com/pfnl/c7ed112b8012f816be298b2d96d2407f538edc6b88a9bedabdfb.html?way=mcp) 江西省伍某集装箱有限公司诉广东创某建筑劳务有限公司承揽合同纠纷案 — 最高人民法院，2025-06-14，参考案例，承揽合同纠纷\n 裁判要点：库里没有裁判要点\n 裁判结果：库里没有裁判主文\n 正文命中：【裁判理由】 根据合同约定等事实可以认定，案涉纠纷不属于买卖合同纠纷，本案存在争议的主要问题是：案涉纠纷属于承揽合同纠纷还是建设工程施工合同纠纷，以及相应的管辖法院。\n- [(2021)最高法民再145号](https://www.pkulaw.com/pfnl/c7ed112b8012f8166595d67b70b50bf5348ebe7c058fcf80bdfb.html?way=mcp) 知某投资公司诉郑某青房屋租赁合同纠纷案 — 最高人民法院，2025-02-07，参考案例，房屋租赁合同纠纷\n 裁判要点：库里没有裁判要点\n 裁判结果：库里没有裁判主文\n 正文命中：知某投资公司诉郑某青房屋租赁合同纠纷案 ——房屋租赁合同无效所致损失的责任承担 【关键词】 民事 房屋租赁合同 合同无效 责任承担 损失比例 【基本案情】 2007年6月9日，原告深圳市知某投资公司（以下简称知某投资公司）与被告郑某青签订了\n- [(2024)最高法知民终337号](https://www.pkulaw.com/pfnl/c7ed112b8012f816cbd010b489675046bfd1331c2d8b76e7bdfb.html?way=mcp) 恒某种业有限公司诉河南金某种业股份有限公司侵害植物新品种权纠纷案 — 最高人民法院，2025-04-21，参考案例，侵害植物新品种权纠纷\n 裁判要点：库里没有裁判要点\n 裁判结果：库里没有裁判主文\n 正文命中：恒某种业有限公司诉河南金某种业股份有限公司侵害植物新品种权纠纷案 ——运用分子标记法认定品种同一性时扩大检测位点加测应当满足的条件 【关键词】 民事 植物新品种权权属、侵权 侵害植物新品种权 扩大位点加测 【基本案情】 玉米植物新品种“NP0\n\n【本次调用需注意】\n- 还有下一页。用户没有要求更多时停在本页。要继续只把 nextCursor 原样传回 cursor，筛选、排序和 pageSize 不要改。最多 5 页，一次最多 50 条。",
"type": "text"
}
],
"isError": false,
"resultType": "complete",
"structuredContent": {
"hasMore": true,
"items": [
{
"caseClassName": "民事指定管辖",
"caseFlag": "(2025)最高法民辖35号",
"caseGrade": [
"参考案例"
],
"category": [
"民事",
"合同、准合同纠纷",
"合同纠纷",
"承揽合同纠纷"
],
"citation": {
"anchorId": null,
"articleLabel": null,
"articleNumber": null,
"formatBluebook": null,
"formatChinese": "江西省伍某集装箱有限公司诉广东创某建筑劳务有限公司承揽合同纠纷案（(2025)最高法民辖35号）",
"lawShort": null,
"lawTitle": "江西省伍某集装箱有限公司诉广东创某建筑劳务有限公司承揽合同纠纷案",
"url": "https://www.pkulaw.com/pfnl/c7ed112b8012f816be298b2d96d2407f538edc6b88a9bedabdfb.html?way=mcp",
"versionLabel": null
},
"court": "最高人民法院",
"courtLevel": "最高人民法院",
"documentAttr": [
"裁定书"
],
"finalResult": null,
"fulltextSnippet": "【裁判理由】 根据合同约定等事实可以认定，案涉纠纷不属于买卖合同纠纷，本案 存在争议的主要问题是：案涉纠纷属于承揽合同纠纷还是建设工程施工合同纠纷，以及相应的管辖法院。",
"gist": null,
"guidingCaseNo": null,
"judgmentResult": null,
"lastInstanceDate": "2025-06-14",
"party": "江西省伍某集装箱有限公司;广东创某建筑劳务有限公司",
"penalty": null,
"procedure": [
"其他"
],
"subjectAmount": null,
"subjectAmountYuan": null,
"title": "江西省伍某集装箱有限公司诉广东创某建筑劳务有限公司承揽合同纠纷案",
"truncationNote": null
},
{
"caseClassName": "民事再审",
"caseFlag": "(2021)最高法民再145号",
"caseGrade": [
"参考案例"
],
"category": [
"民事",
"合同、准合同纠纷",
"合同纠纷",
"租赁合同纠纷",
"房屋租赁合同纠纷"
],
"citation": {
"anchorId": null,
"articleLabel": null,
"articleNumber": null,
"formatBluebook": null,
"formatChinese": "知某投资公司诉郑某青房屋租赁合同纠纷案（(2021)最高法民再145号）",
"lawShort": null,
"lawTitle": "知某投资公司诉郑某青房屋租赁合同纠纷案",
"url": "https://www.pkulaw.com/pfnl/c7ed112b8012f8166595d67b70b50bf5348ebe7c058fcf80bdfb.html?way=mcp",
"versionLabel": null
},
"court": "最高人民法院",
"courtLevel": "最高人民法院",
"documentAttr": [
"判决书"
],
"finalResult": [
"全部改判"
],
"fulltextSnippet": "知某投资公司诉郑某青房屋租赁合同纠纷案 ——房屋租赁合同无效所致损失的责任承担 【关键词】 民事 房屋租赁合同 合同无效 责任承担 损失比例 【基本案情】 2007年6月9日，原告深圳市知某投资公司（以下简称知某投资公司）与被告郑某青签订了",
"gist": null,
"guidingCaseNo": null,
"judgmentResult": null,
"lastInstanceDate": "2025-02-07",
"party": "知某投资公司;郑某青",
"penalty": null,
"procedure": [
"再审"
],
"subjectAmount": null,
"subjectAmountYuan": null,
"title": "知某投资公司诉郑某青房屋租赁合同纠纷案",
"truncationNote": null
},
{
"caseClassName": "民事二审",
"caseFlag": "(2024)最高法知民终337号",
"caseGrade": [
"参考案例"
],
"category": [
"民事",
"知识产权与竞争纠纷",
"知识产权权属、侵权纠纷",
"植物新品种权权属、侵权纠纷",
"侵害植物新品种权纠纷"
],
"citation": {
"anchorId": null,
"articleLabel": null,
"articleNumber": null,
"formatBluebook": null,
"formatChinese": "恒某种业有限公司诉河南金某种业股份有限公司侵害植物新品种权纠纷案（(2024)最高法知民终337号）",
"lawShort": null,
"lawTitle": "恒某种业有限公司诉河南金某种业股份有限公司侵害植物新品种权纠纷案",
"url": "https://www.pkulaw.com/pfnl/c7ed112b8012f816cbd010b489675046bfd1331c2d8b76e7bdfb.html?way=mcp",
"versionLabel": null
},
"court": "最高人民法院",
"courtLevel": "最高人民法院",
"documentAttr": [
"判决书"
],
"finalResult": [
"全部改判"
],
"fulltextSnippet": "恒某种业有限公司诉河南金某种业股份有限公司侵害植物新品种权纠纷案 ——运用分子标记法认定品种同一性时扩大检测位点加测应当满足的条件 【关键词】 民事 植物新品种权权属、侵权 侵害植物新品种权 扩大位点加测 【基本案情】 玉米植物新品种“NP0",
"gist": null,
"guidingCaseNo": null,
"judgmentResult": null,
"lastInstanceDate": "2025-04-21",
"party": "恒某种业有限公司;河南金某种业股份有限公司",
"penalty": null,
"procedure": [
"二审"
],
"subjectAmount": null,
"subjectAmountYuan": null,
"title": "恒某种业有限公司诉河南金某种业股份有限公司侵害植物新品种权纠纷案",
"truncationNote": null
}
],
"nextCursor": "YzA2ZDMxMzM5ODVlYWMwYzZkZDM3YzRhOWZmYWM3NzYwNGJlNmRmMTEzMzAwNTJiMjc3NWQ1NjQxNmUyZDQxYy57InBhZ2UiOjIsImZwIjoiM2MxODNiM2Q4N2M3NjY4ZjQ1N2MzYzM2NjM5YTRjODJjMzg4YTY4MGUyZGNlMGMzNzAyNWNiMWE1NDIwMjM2YSIsInNhIjpbMTIuNTA1NzM0LDE3NDUxOTM2MDAwMDAsIjE5NzAzMjU0MTYwMzMwMzEiXX0",
"totalCount": 7
}
}Agent integration
Copy the resource contract without sharing an API key.
View API Markdown
API Markdown
# Judicial Case Search - Keyword — get_case_list
Keyword case search (including full element breakdown)
## Available implementations
pkulaw · Judicial Case Search - Keyword — get_case_list: https://openany.si/markets/apis/capabilities/pkulaw-judicial-case-search-keyword-get-case-list?offering=eb3e185d-ccae-4a40-9c25-0ddefc2ff798 · $0.05 / call
## Selected API contract
Documentation: https://openany.si/markets/apis/capabilities/pkulaw-judicial-case-search-keyword-get-case-list
Method: POST
Endpoint: https://api.openany.si/v1/agent-apis/pkulaw/case-keyword/get_case_list
Price: $0.05 / call
Provider: pkulaw
Contract revision: 3
Price source: selected implementation in the OpenAny public API catalog. Price update time: not supplied.
Use OPENANY_API_KEY from the environment. API Key calls use your shared balance.
## Prepared request
```bash
curl \
'https://api.openany.si/v1/agent-apis/pkulaw/case-keyword/get_case_list' \
-X POST \
-H "Authorization: Bearer $OPENANY_API_KEY" \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
--data-raw '{
"caseClassName": "民事",
"caseGrade": [
"指导性案例",
"参考案例"
],
"court": "最高人民法院",
"documentAttr": [
"判决书",
"裁定书"
],
"endLastInstanceDate": "2026.7.1",
"fulltext": "合同纠纷",
"pageSize": 3,
"startLastInstanceDate": "2025.1.1",
"title": "纠纷"
}'
```
## API contract
```json
{
"resource_type": "api",
"name": "Judicial Case Search - Keyword — get_case_list",
"endpoint": "https://api.openany.si/v1/agent-apis/pkulaw/case-keyword/get_case_list",
"method": "POST",
"content_type": "application/json",
"execution_mode": "sync",
"authentication": {
"type": "bearer",
"environment_variable": "OPENANY_API_KEY"
},
"inputs": [
{
"description": "Keyword case search (including full element breakdown)",
"json_schema": {
"properties": {
"accusation": {
"default": "",
"description": "Offense of conviction, e.g. `危险驾驶罪` (dangerous driving). Can be searched on its own. An unrecognized value causes an error rather than silently dropping this condition.",
"maxLength": 50,
"title": "accusation",
"type": "string"
},
"caseClassName": {
"default": "",
"description": "Case type name, matched by name containment, e.g. `民事一审` (civil first instance). `民事` (civil) alone includes both civil first-instance and civil second-instance cases.",
"maxLength": 20,
"title": "caseClassName",
"type": "string"
},
"caseFlag": {
"default": "",
"description": "Case number, matched as a complete phrase, e.g. `（2020）京01民终1234号`.",
"maxLength": 80,
"title": "caseFlag",
"type": "string"
},
"caseGrade": {
"default": [],
"description": "Reference levels, at most 4, combined with OR, e.g. [\"指导性案例\"] (guiding cases). Do not supply names of sublevels.",
"items": {
"enum": [
"指导性案例",
"公报案例",
"典型案例",
"参阅案例",
"经典案例",
"法宝推荐",
"普通案例",
"应用案例",
"评析案例",
"优秀案例",
"参考案例"
],
"type": "string"
},
"maxItems": 4,
"title": "caseGrade",
"type": "array"
},
"category": {
"default": [],
"description": "Causes of action, at most 5, combined with OR, e.g. [\"租赁合同纠纷\"] (lease contract disputes). When reusing a returned path as input, pass only the final level.",
"items": {
"maxLength": 50,
"type": "string"
},
"maxItems": 5,
"title": "category",
"type": "array"
},
"court": {
"default": "",
"description": "Name of a specific court, e.g. `北京市朝阳区人民法院` (Chaoyang District People's Court of Beijing). `最高人民法院` searches that specific court, the Supreme People's Court. Do not enter a court level such as `中级人民法院` (intermediate people's court); use courtLevel for that.",
"maxLength": 40,
"title": "court",
"type": "string"
},
"courtLevel": {
"anyOf": [
{
"enum": [
"最高人民法院",
"高级人民法院",
"中级人民法院",
"基层人民法院",
"专门人民法院"
],
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Court level, e.g. `中级人民法院` (intermediate people's court). If omitted, no restriction applies.",
"title": "courtLevel"
},
"cursor": {
"default": "",
"description": "Pass back nextCursor from the previous page unchanged. For example, an empty string denotes the first page. Do not supply it unless the user requests more results. Keep filters, sorting, and pageSize the same as on the previous page.",
"maxLength": 512,
"title": "cursor",
"type": "string"
},
"documentAttr": {
"default": [],
"description": "Document types, at most 3, combined with OR, e.g. [\"判决书\"] (judgments). Cannot be the sole condition.",
"items": {
"enum": [
"判决书",
"裁定书",
"决定书",
"调解书",
"其他文书",
"通知书",
"支付令"
],
"type": "string"
},
"maxItems": 3,
"title": "documentAttr",
"type": "array"
},
"endLastInstanceDate": {
"default": "",
"description": "Case conclusion date to, inclusive, e.g. `2024.12.31` or `2024-12-31`.",
"maxLength": 10,
"title": "endLastInstanceDate",
"type": "string"
},
"finalResult": {
"anyOf": [
{
"enum": [
"维持原判",
"全部改判",
"驳回再审申请",
"裁定终结再审",
"部分维持、部分改判",
"部分维持、部分加判",
"发回重审",
"裁定再审",
"裁定提审"
],
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Final-instance outcome; supply only one, e.g. `维持原判` (original judgment upheld). Cannot be the sole condition.",
"title": "finalResult"
},
"fulltext": {
"default": "",
"description": "Full-text keywords, e.g. `押金` (deposit). Spaces and commas mean AND; | means OR. Returns matching excerpts only, not the document's full text.",
"maxLength": 40,
"title": "fulltext",
"type": "string"
},
"gist": {
"default": "",
"description": "Keywords in key adjudication points, matched as contiguous phrases, e.g. `违约金` (liquidated damages). Spaces and commas mean AND; | means OR.",
"maxLength": 40,
"title": "gist",
"type": "string"
},
"judge": {
"default": "",
"description": "Name of the hearing judge, matched as a contiguous phrase, e.g. `王某` (Wang, anonymized). Cannot be the sole condition.",
"maxLength": 40,
"title": "judge",
"type": "string"
},
"pageSize": {
"default": 10,
"description": "Number of results on this page, e.g. 10; maximum 50. A search can retrieve at most 50 results across 5 pages. Keep this value the same as on the previous page when paginating.",
"maximum": 50,
"minimum": 1,
"title": "pageSize",
"type": "integer"
},
"party": {
"default": "",
"description": "Party names, matched as contiguous phrases, e.g. `张某` (Zhang, anonymized). Spaces and commas mean AND; | means OR.",
"maxLength": 40,
"title": "party",
"type": "string"
},
"penalty": {
"default": [],
"description": "Sentencing categories, at most 3, combined with OR, e.g. [\"三年以下\"] (three years or less). Terms with subcategories include those subcategories in the search. `缓刑` (suspended sentence) is not available. Cannot be the sole condition.",
"items": {
"enum": [
"主刑",
"管制",
"拘役",
"有期徒刑",
"三年以下",
"三年以上不满十年",
"十年以上",
"无期徒刑",
"死刑立即执行",
"死刑缓期执行",
"社区矫正",
"数罪并罚",
"羁押1日折抵刑期2日",
"羁押1日折抵刑期1日",
"附加刑",
"罚金",
"单处罚金",
"并处罚金",
"没收财产",
"剥夺政治权利",
"驱逐出境",
"非刑罚处罚措施",
"赔礼道歉",
"责令赔偿被害人经济损失",
"职业禁止",
"禁业",
"刑罚执行",
"撤销假释",
"监外执行",
"保外就医",
"怀孕",
"正在哺乳",
"社会危险",
"自伤自残",
"刑罚消灭",
"追诉时效",
"不再追诉",
"赦免"
],
"type": "string"
},
"maxItems": 3,
"title": "penalty",
"type": "array"
},
"procedure": {
"anyOf": [
{
"enum": [
"一审",
"二审",
"再审",
"死刑复核",
"简易程序",
"速裁程序",
"特别程序",
"督促",
"公示催告",
"执行",
"破产",
"国家赔偿",
"其他"
],
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Procedure; supply only one, e.g. `二审` (second instance). To retrieve first-instance or second-instance cases, make two calls.",
"title": "procedure"
},
"sort": {
"default": "relevance",
"description": "Sort order, e.g. relevance. Use judgmentDateDesc for newest first or judgmentDateAsc for oldest first.",
"enum": [
"relevance",
"judgmentDateDesc",
"judgmentDateAsc"
],
"title": "sort",
"type": "string"
},
"startLastInstanceDate": {
"default": "",
"description": "Case conclusion date from, inclusive, e.g. `2024.1.1` or `2024-01-01`.",
"maxLength": 10,
"title": "startLastInstanceDate",
"type": "string"
},
"subjectAmount": {
"default": [],
"description": "Amount-in-dispute bands, at most 3, combined with OR, e.g. [\"100-500万\"] (1-5 million yuan). Amounts are in yuan; 0 yuan is excluded. Cannot be the sole condition.",
"items": {
"enum": [
"0-10万",
"10-50万",
"50-100万",
"100-500万",
"500-1000万",
"1000-5000万",
"5000万以上"
],
"type": "string"
},
"maxItems": 3,
"title": "subjectAmount",
"type": "array"
},
"title": {
"default": "",
"description": "Title keywords, e.g. `房屋租赁合同` (residential lease contract). Spaces and commas mean AND; | means OR. The Chinese enumeration comma does not split terms.",
"maxLength": 120,
"title": "title",
"type": "string"
}
},
"title": "get_case_listArguments",
"type": "object"
},
"location": "body",
"name": "body",
"nullable": false,
"pointer": "",
"required": true,
"type": "object"
}
],
"billing": {
"currency": "USD",
"mode": "fixed",
"priceMicroUsd": "50000",
"rounding": null,
"unit": "call",
"unitQuantity": null
},
"examples": [
{
"http_status": 200,
"name": "Documentation example",
"request": {
"body": {
"caseClassName": "民事",
"caseGrade": [
"指导性案例",
"参考案例"
],
"court": "最高人民法院",
"documentAttr": [
"判决书",
"裁定书"
],
"endLastInstanceDate": "2026.7.1",
"fulltext": "合同纠纷",
"pageSize": 3,
"startLastInstanceDate": "2025.1.1",
"title": "纠纷"
},
"headers": {
"Accept": "application/json"
},
"path": {},
"query": {}
},
"response_body": {
"_meta": {
"io.modelcontextprotocol/serverInfo": {
"name": "mcp-case",
"title": "北大法宝·案例关键词检索",
"version": "2.0.0"
},
"pkulaw/evidence": {
"confidence": "B",
"notes": [],
"origin": "catalog",
"retrievedAt": "2026-10-28T12:43:21Z",
"verifiedByApi": true
},
"pkulaw/limits": [
"还有下一页。用户没有要求更多时停在本页。要继续只把 nextCursor 原样传回 cursor，筛选、排序和 pageSize 不要改。最多 5 页，一次最多 50 条。"
]
},
"content": [
{
"text": "命中 7，本页 3 条，第 1 页，最多 5 页，一次最多 50 条。用户没有要求更多时停在本页。要继续把 nextCursor 原样传回 cursor，筛选、排序和 pageSize 不要改。本页法院集中在 最高人民法院。要看其他法院请改 court 或 courtLevel 后重新检索，只翻页仍会堆在同一排序里。\n- [(2025)最高法民辖35号](https://www.pkulaw.com/pfnl/c7ed112b8012f816be298b2d96d2407f538edc6b88a9bedabdfb.html?way=mcp) 江西省伍某集装箱有限公司诉广东创某建筑劳务有限公司承揽合同纠纷案 — 最高人民法院，2025-06-14，参考案例，承揽合同纠纷\n 裁判要点：库里没有裁判要点\n 裁判结果：库里没有裁判主文\n 正文命中：【裁判理由】 根据合同约定等事实可以认定，案涉纠纷不属于买卖合同纠纷，本案存在争议的主要问题是：案涉纠纷属于承揽合同纠纷还是建设工程施工合同纠纷，以及相应的管辖法院。\n- [(2021)最高法民再145号](https://www.pkulaw.com/pfnl/c7ed112b8012f8166595d67b70b50bf5348ebe7c058fcf80bdfb.html?way=mcp) 知某投资公司诉郑某青房屋租赁合同纠纷案 — 最高人民法院，2025-02-07，参考案例，房屋租赁合同纠纷\n 裁判要点：库里没有裁判要点\n 裁判结果：库里没有裁判主文\n 正文命中：知某投资公司诉郑某青房屋租赁合同纠纷案 ——房屋租赁合同无效所致损失的责任承担 【关键词】 民事 房屋租赁合同 合同无效 责任承担 损失比例 【基本案情】 2007年6月9日，原告深圳市知某投资公司（以下简称知某投资公司）与被告郑某青签订了\n- [(2024)最高法知民终337号](https://www.pkulaw.com/pfnl/c7ed112b8012f816cbd010b489675046bfd1331c2d8b76e7bdfb.html?way=mcp) 恒某种业有限公司诉河南金某种业股份有限公司侵害植物新品种权纠纷案 — 最高人民法院，2025-04-21，参考案例，侵害植物新品种权纠纷\n 裁判要点：库里没有裁判要点\n 裁判结果：库里没有裁判主文\n 正文命中：恒某种业有限公司诉河南金某种业股份有限公司侵害植物新品种权纠纷案 ——运用分子标记法认定品种同一性时扩大检测位点加测应当满足的条件 【关键词】 民事 植物新品种权权属、侵权 侵害植物新品种权 扩大位点加测 【基本案情】 玉米植物新品种“NP0\n\n【本次调用需注意】\n- 还有下一页。用户没有要求更多时停在本页。要继续只把 nextCursor 原样传回 cursor，筛选、排序和 pageSize 不要改。最多 5 页，一次最多 50 条。",
"type": "text"
}
],
"isError": false,
"resultType": "complete",
"structuredContent": {
"hasMore": true,
"items": [
{
"caseClassName": "民事指定管辖",
"caseFlag": "(2025)最高法民辖35号",
"caseGrade": [
"参考案例"
],
"category": [
"民事",
"合同、准合同纠纷",
"合同纠纷",
"承揽合同纠纷"
],
"citation": {
"anchorId": null,
"articleLabel": null,
"articleNumber": null,
"formatBluebook": null,
"formatChinese": "江西省伍某集装箱有限公司诉广东创某建筑劳务有限公司承揽合同纠纷案（(2025)最高法民辖35号）",
"lawShort": null,
"lawTitle": "江西省伍某集装箱有限公司诉广东创某建筑劳务有限公司承揽合同纠纷案",
"url": "https://www.pkulaw.com/pfnl/c7ed112b8012f816be298b2d96d2407f538edc6b88a9bedabdfb.html?way=mcp",
"versionLabel": null
},
"court": "最高人民法院",
"courtLevel": "最高人民法院",
"documentAttr": [
"裁定书"
],
"finalResult": null,
"fulltextSnippet": "【裁判理由】 根据合同约定等事实可以认定，案涉纠纷不属于买卖合同纠纷，本案存在争议的主要问题是：案涉纠纷属于承揽合同纠纷还是建设工程施工合同纠纷，以及相应的管辖法院。",
"gist": null,
"guidingCaseNo": null,
"judgmentResult": null,
"lastInstanceDate": "2025-06-14",
"party": "江西省伍某集装箱有限公司;广东创某建筑劳务有限公司",
"penalty": null,
"procedure": [
"其他"
],
"subjectAmount": null,
"subjectAmountYuan": null,
"title": "江西省伍某集装箱有限公司诉广东创某建筑劳务有限公司承揽合同纠纷案",
"truncationNote": null
},
{
"caseClassName": "民事再审",
"caseFlag": "(2021)最高法民再145号",
"caseGrade": [
"参考案例"
],
"category": [
"民事",
"合同、准合同纠纷",
"合同纠纷",
"租赁合同纠纷",
"房屋租赁合同纠纷"
],
"citation": {
"anchorId": null,
"articleLabel": null,
"articleNumber": null,
"formatBluebook": null,
"formatChinese": "知某投资公司诉郑某青房屋租赁合同纠纷案（(2021)最高法民再145号）",
"lawShort": null,
"lawTitle": "知某投资公司诉郑某青房屋租赁合同纠纷案",
"url": "https://www.pkulaw.com/pfnl/c7ed112b8012f8166595d67b70b50bf5348ebe7c058fcf80bdfb.html?way=mcp",
"versionLabel": null
},
"court": "最高人民法院",
"courtLevel": "最高人民法院",
"documentAttr": [
"判决书"
],
"finalResult": [
"全部改判"
],
"fulltextSnippet": "知某投资公司诉郑某青房屋租赁合同纠纷案 ——房屋租赁合同无效所致损失的责任承担 【关键词】 民事 房屋租赁合同 合同无效 责任承担 损失比例 【基本案情】 2007年6月9日，原告深圳市知某投资公司（以下简称知某投资公司）与被告郑某青签订了",
"gist": null,
"guidingCaseNo": null,
"judgmentResult": null,
"lastInstanceDate": "2025-02-07",
"party": "知某投资公司;郑某青",
"penalty": null,
"procedure": [
"再审"
],
"subjectAmount": null,
"subjectAmountYuan": null,
"title": "知某投资公司诉郑某青房屋租赁合同纠纷案",
"truncationNote": null
},
{
"caseClassName": "民事二审",
"caseFlag": "(2024)最高法知民终337号",
"caseGrade": [
"参考案例"
],
"category": [
"民事",
"知识产权与竞争纠纷",
"知识产权权属、侵权纠纷",
"植物新品种权权属、侵权纠纷",
"侵害植物新品种权纠纷"
],
"citation": {
"anchorId": null,
"articleLabel": null,
"articleNumber": null,
"formatBluebook": null,
"formatChinese": "恒某种业有限公司诉河南金某种业股份有限公司侵害植物新品种权纠纷案（(2024)最高法知民终337号）",
"lawShort": null,
"lawTitle": "恒某种业有限公司诉河南金某种业股份有限公司侵害植物新品种权纠纷案",
"url": "https://www.pkulaw.com/pfnl/c7ed112b8012f816cbd010b489675046bfd1331c2d8b76e7bdfb.html?way=mcp",
"versionLabel": null
},
"court": "最高人民法院",
"courtLevel": "最高人民法院",
"documentAttr": [
"判决书"
],
"finalResult": [
"全部改判"
],
"fulltextSnippet": "恒某种业有限公司诉河南金某种业股份有限公司侵害植物新品种权纠纷案 ——运用分子标记法认定品种同一性时扩大检测位点加测应当满足的条件 【关键词】 民事 植物新品种权权属、侵权 侵害植物新品种权 扩大位点加测 【基本案情】 玉米植物新品种“NP0",
"gist": null,
"guidingCaseNo": null,
"judgmentResult": null,
"lastInstanceDate": "2025-04-21",
"party": "恒某种业有限公司;河南金某种业股份有限公司",
"penalty": null,
"procedure": [
"二审"
],
"subjectAmount": null,
"subjectAmountYuan": null,
"title": "恒某种业有限公司诉河南金某种业股份有限公司侵害植物新品种权纠纷案",
"truncationNote": null
}
],
"nextCursor": "YzA2ZDMxMzM5ODVlYWMwYzZkZDM3YzRhOWZmYWM3NzYwNGJlNmRmMTEzMzAwNTJiMjc3NWQ1NjQxNmUyZDQxYy57InBhZ2UiOjIsImZwIjoiM2MxODNiM2Q4N2M3NjY4ZjQ1N2MzYzM2NjM5YTRjODJjMzg4YTY4MGUyZGNlMGMzNzAyNWNiMWE1NDIwMjM2YSIsInNhIjpbMTIuNTA1NzM0LDE3NDUxOTM2MDAwMDAsIjE5NzAzMjU0MTYwMzMwMzEiXX0",
"totalCount": 7
}
}
}
]
}
```Error handling
| Status | Next step |
|---|---|
400 | Check the offering and request fields. |
401 / 403 | Verify your credentials and access permissions. |
402 | Inspect the selected access mode and returned payment requirements. |
429 | Respect the returned rate limit and retry guidance. |
5xx | Inspect the error and usage record before retrying a paid operation. |
Documentation example
Published documentation example. Verify the actual response after an approved call.
Prepare your environment
Use a terminal with cURL installed.
Use an OpenAny API key with shared-balance access. Confirm availability and price before running; a call may charge your balance.
Set the key in your terminal using the hidden prompt below. Keep its value out of source files and logs.
Terminal · macOS / Linuxprintf 'OpenAny API key: ' read -r -s OPENANY_API_KEY export OPENANY_API_KEY printf '\n'Run the request
Paste the complete command below into your terminal.
Values to replace before running 1
Review these request fields before running. Keep the published provider and request method unchanged.
body- Keyword case search (including full element breakdown)
Terminal · cURLcurl \ 'https://api.openany.si/v1/agent-apis/pkulaw/case-keyword/get_case_list' \ -X POST \ -H "Authorization: Bearer $OPENANY_API_KEY" \ -H 'Content-Type: application/json' \ -H 'Accept: application/json' \ --data-raw '{ "caseClassName": "民事", "caseGrade": [ "指导性案例", "参考案例" ], "court": "最高人民法院", "documentAttr": [ "判决书", "裁定书" ], "endLastInstanceDate": "2026.7.1", "fulltext": "合同纠纷", "pageSize": 3, "startLastInstanceDate": "2025.1.1", "title": "纠纷" }'Check the response
Published response example · Documented HTTP 200; not a live result.
Sample response · not a live result{ "_meta": { "io.modelcontextprotocol/serverInfo": { "name": "mcp-case", "title": "北大法宝·案例关键词检索", "version": "2.0.0" }, "pkulaw/evidence": { "confidence": "B", "notes": [], "origin": "catalog", "retrievedAt": "2026-10-28T12:43:21Z", "verifiedByApi": true }, "pkulaw/limits": [ "还有下一页。用户没有要求更多时停在本页。要继续只把 nextCursor 原样传回 cursor，筛选、排序和 pageSize 不要改。最多 5 页，一次最多 50 条。" ] }, "content": [ { "text": "命中 7，本页 3 条，第 1 页，最多 5 页，一次最多 50 条。用户没有要求更多时停在本页。要继续把 nextCursor 原样传回 cursor，筛选、排序和 pageSize 不要改。本页法院集中在 最高人民法院。要看其他法院请改 court 或 courtLevel 后重新检索，只翻页仍会堆在同一排序里。\n- [(2025)最高法民辖35号](https://www.pkulaw.com/pfnl/c7ed112b8012f816be298b2d96d2407f538edc6b88a9bedabdfb.html?way=mcp) 江西省伍某集装箱有限公司诉广东创某建筑劳务有限公司承揽合同纠纷案 — 最高人民法院，2025-06-14，参考案例，承揽合同纠纷\n 裁判要点：库里没有裁判要点\n 裁判结果：库里没有裁判主文\n 正文命中：【裁判理由】 根据合同约定等事实可以认定，案涉纠纷不属于买卖合同纠纷，本案存在争议的主要问题是：案涉纠纷属于承揽合同纠纷还是建设工程施工合同纠纷，以及相应的管辖法院。\n- [(2021)最高法民再145号](https://www.pkulaw.com/pfnl/c7ed112b8012f8166595d67b70b50bf5348ebe7c058fcf80bdfb.html?way=mcp) 知某投资公司诉郑某青房屋租赁合同纠纷案 — 最高人民法院，2025-02-07，参考案例，房屋租赁合同纠纷\n 裁判要点：库里没有裁判要点\n 裁判结果：库里没有裁判主文\n 正文命中：知某投资公司诉郑某青房屋租赁合同纠纷案 ——房屋租赁合同无效所致损失的责任承担 【关键词】 民事 房屋租赁合同 合同无效 责任承担 损失比例 【基本案情】 2007年6月9日，原告深圳市知某投资公司（以下简称知某投资公司）与被告郑某青签订了\n- [(2024)最高法知民终337号](https://www.pkulaw.com/pfnl/c7ed112b8012f816cbd010b489675046bfd1331c2d8b76e7bdfb.html?way=mcp) 恒某种业有限公司诉河南金某种业股份有限公司侵害植物新品种权纠纷案 — 最高人民法院，2025-04-21，参考案例，侵害植物新品种权纠纷\n 裁判要点：库里没有裁判要点\n 裁判结果：库里没有裁判主文\n 正文命中：恒某种业有限公司诉河南金某种业股份有限公司侵害植物新品种权纠纷案 ——运用分子标记法认定品种同一性时扩大检测位点加测应当满足的条件 【关键词】 民事 植物新品种权权属、侵权 侵害植物新品种权 扩大位点加测 【基本案情】 玉米植物新品种“NP0\n\n【本次调用需注意】\n- 还有下一页。用户没有要求更多时停在本页。要继续只把 nextCursor 原样传回 cursor，筛选、排序和 pageSize 不要改。最多 5 页，一次最多 50 条。", "type": "text" } ], "isError": false, "resultType": "complete", "structuredContent": { "hasMore": true, "items": [ { "caseClassName": "民事指定管辖", "caseFlag": "(2025)最高法民辖35号", "caseGrade": [ "参考案例" ], "category": [ "民事", "合同、准合同纠纷", "合同纠纷", "承揽合同纠纷" ], "citation": { "anchorId": null, "articleLabel": null, "articleNumber": null, "formatBluebook": null, "formatChinese": "江西省伍某集装箱有限公司诉广东创某建筑劳务有限公司承揽合同纠纷案（(2025)最高法民辖35号）", "lawShort": null, "lawTitle": "江西省伍某集装箱有限公司诉广东创某建筑劳务有限公司承揽合同纠纷案", "url": "https://www.pkulaw.com/pfnl/c7ed112b8012f816be298b2d96d2407f538edc6b88a9bedabdfb.html?way=mcp", "versionLabel": null }, "court": "最高人民法院", "courtLevel": "最高人民法院", "documentAttr": [ "裁定书" ], "finalResult": null, "fulltextSnippet": "【裁判理由】 根据合同约定等事实可以认定，案涉纠纷不属于买卖合同纠纷，本案 存在争议的主要问题是：案涉纠纷属于承揽合同纠纷还是建设工程施工合同纠纷，以及相应的管辖法院。", "gist": null, "guidingCaseNo": null, "judgmentResult": null, "lastInstanceDate": "2025-06-14", "party": "江西省伍某集装箱有限公司;广东创某建筑劳务有限公司", "penalty": null, "procedure": [ "其他" ], "subjectAmount": null, "subjectAmountYuan": null, "title": "江西省伍某集装箱有限公司诉广东创某建筑劳务有限公司承揽合同纠纷案", "truncationNote": null }, { "caseClassName": "民事再审", "caseFlag": "(2021)最高法民再145号", "caseGrade": [ "参考案例" ], "category": [ "民事", "合同、准合同纠纷", "合同纠纷", "租赁合同纠纷", "房屋租赁合同纠纷" ], "citation": { "anchorId": null, "articleLabel": null, "articleNumber": null, "formatBluebook": null, "formatChinese": "知某投资公司诉郑某青房屋租赁合同纠纷案（(2021)最高法民再145号）", "lawShort": null, "lawTitle": "知某投资公司诉郑某青房屋租赁合同纠纷案", "url": "https://www.pkulaw.com/pfnl/c7ed112b8012f8166595d67b70b50bf5348ebe7c058fcf80bdfb.html?way=mcp", "versionLabel": null }, "court": "最高人民法院", "courtLevel": "最高人民法院", "documentAttr": [ "判决书" ], "finalResult": [ "全部改判" ], "fulltextSnippet": "知某投资公司诉郑某青房屋租赁合同纠纷案 ——房屋租赁合同无效所致损失的责任承担 【关键词】 民事 房屋租赁合同 合同无效 责任承担 损失比例 【基本案情】 2007年6月9日，原告深圳市知某投资公司（以下简称知某投资公司）与被告郑某青签订了", "gist": null, "guidingCaseNo": null, "judgmentResult": null, "lastInstanceDate": "2025-02-07", "party": "知某投资公司;郑某青", "penalty": null, "procedure": [ "再审" ], "subjectAmount": null, "subjectAmountYuan": null, "title": "知某投资公司诉郑某青房屋租赁合同纠纷案", "truncationNote": null }, { "caseClassName": "民事二审", "caseFlag": "(2024)最高法知民终337号", "caseGrade": [ "参考案例" ], "category": [ "民事", "知识产权与竞争纠纷", "知识产权权属、侵权纠纷", "植物新品种权权属、侵权纠纷", "侵害植物新品种权纠纷" ], "citation": { "anchorId": null, "articleLabel": null, "articleNumber": null, "formatBluebook": null, "formatChinese": "恒某种业有限公司诉河南金某种业股份有限公司侵害植物新品种权纠纷案（(2024)最高法知民终337号）", "lawShort": null, "lawTitle": "恒某种业有限公司诉河南金某种业股份有限公司侵害植物新品种权纠纷案", "url": "https://www.pkulaw.com/pfnl/c7ed112b8012f816cbd010b489675046bfd1331c2d8b76e7bdfb.html?way=mcp", "versionLabel": null }, "court": "最高人民法院", "courtLevel": "最高人民法院", "documentAttr": [ "判决书" ], "finalResult": [ "全部改判" ], "fulltextSnippet": "恒某种业有限公司诉河南金某种业股份有限公司侵害植物新品种权纠纷案 ——运用分子标记法认定品种同一性时扩大检测位点加测应当满足的条件 【关键词】 民事 植物新品种权权属、侵权 侵害植物新品种权 扩大位点加测 【基本案情】 玉米植物新品种“NP0", "gist": null, "guidingCaseNo": null, "judgmentResult": null, "lastInstanceDate": "2025-04-21", "party": "恒某种业有限公司;河南金某种业股份有限公司", "penalty": null, "procedure": [ "二审" ], "subjectAmount": null, "subjectAmountYuan": null, "title": "恒某种业有限公司诉河南金某种业股份有限公司侵害植物新品种权纠纷案", "truncationNote": null } ], "nextCursor": "YzA2ZDMxMzM5ODVlYWMwYzZkZDM3YzRhOWZmYWM3NzYwNGJlNmRmMTEzMzAwNTJiMjc3NWQ1NjQxNmUyZDQxYy57InBhZ2UiOjIsImZwIjoiM2MxODNiM2Q4N2M3NjY4ZjQ1N2MzYzM2NjM5YTRjODJjMzg4YTY4MGUyZGNlMGMzNzAyNWNiMWE1NDIwMjM2YSIsInNhIjpbMTIuNTA1NzM0LDE3NDUxOTM2MDAwMDAsIjE5NzAzMjU0MTYwMzMwMzEiXX0", "totalCount": 7 } }
Common questions
Do I need a separate key for every provider?
Use your OpenAny API key for standard API access. Read it from OPENANY_API_KEY in your environment and keep it out of prompts, source code and logs.
Are these providers interchangeable?
No. Each offering has its own inputs, pricing and response contract. Selecting a catalog offering does not establish automatic routing or fallback. Confirm the service contract before calling.
How is this API billed?
API-key calls use your shared balance at the selected implementation's published rate. Check the billing unit and request-specific pricing rules before making a paid call. Recorded usage determines the final charge under that contract.
Where do the price and contract come from?
The selected implementation publishes its provider, request contract, revision and billing rules through OpenAny's public API catalog. A revision number identifies a contract version, not a price update date. A price update timestamp is not supplied; do not treat a page date as one.
How do OpenAny Balance and x402 differ?
OpenAny Balance uses an API key and one shared balance. Card, USDC and x402 top-ups, card auto top-up and USDC subscriptions fund that balance; available routes appear on the Credits page. Direct x402 is a separate pay-per-request flow, available only on listings that show it and requiring an authorized payment client.
Does Playground send a paid request?
Yes. After you sign in, Run sends a real API request using an active OpenAny API key. Charges follow the published API contract and use your shared balance. Selecting an implementation, editing inputs and viewing sample responses do not send requests.