企业涉诉信息统计接口 API 文档
根据企业ID或统一社会信用代码针对企业涉诉信息,统计不同维度的分布情况(案件类别、案由、文书种类、审判程序、法院层级、结案方式、结案年份、地域、诉讼身份、对手当事人身份)
接口概览
| 接口名称 | 企业涉诉信息统计接口 |
|---|---|
| 接口描述 | 根据企业ID或统一社会信用代码针对企业涉诉信息,统计不同维度的分布情况(案件类别、案由、文书种类、审判程序、法院层级、结案方式、结案年份、地域、诉讼身份、对手当事人身份) |
| 接口分类 | 企业信息 |
| 调用地址 | https://open.chineselaw.com/open/rh_enterpriseWritAgg |
| 请求方式 | GET |
请求参数
3. 请求参数(Query)
| 参数名 | 类型 | 是否必填 | 说明 |
|---|---|---|---|
id |
string | 否 | 企业ID |
tyshxydm |
string | 否 | 统一社会信用代码 |
id与tyshxydm不能同时为空。
响应参数
5. 响应说明
5.1 通用返回结构
| 字段名 | 类型 | 说明 |
|---|---|---|
status |
string | success / notFound 等 |
code |
number | 成功 200 |
message |
string | 提示信息 |
data |
object | 数据结果 |
5.2 data 对象说明(概要)
| 字段名 | 类型 | 说明 |
|---|---|---|
id |
string | 企业ID |
name |
string | 企业名称 |
total |
number | 总数 |
错误码
暂无错误码说明
调用示例
CURL
curl --location --request GET 'https://open.chineselaw.com/open/rh_enterpriseWritAgg?id=a80a4cc8-9954-4dd3-bcaf-aebb99487b14' \
--header 'X-API-Key: 你的api_key' \
--header 'Accept: application/json'JAVA
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.time.Duration;
public class EnterpriseWritAggExample {
public static void main(String[] args) throws Exception {
String apiKey = "你的api_key";
String url = "https://open.chineselaw.com/open/rh_enterpriseWritAgg?id=a80a4cc8-9954-4dd3-bcaf-aebb99487b14";
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create(url))
.timeout(Duration.ofSeconds(60))
.header("X-API-Key", apiKey)
.header("Accept", "application/json")
.GET()
.build();
HttpClient client = HttpClient.newHttpClient();
HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.statusCode());
System.out.println(response.body());
}
}PYTHON
import requests
url = "https://open.chineselaw.com/open/rh_enterpriseWritAgg"
API_KEY = "你的api_key"
headers = {
"X-API-Key": API_KEY,
"Accept": "application/json",
}
params = {
'id': 'a80a4cc8-9954-4dd3-bcaf-aebb99487b14',
}
response = requests.get(url, params=params, headers=headers, timeout=60)
response.raise_for_status()
print(response.json())JAVASCRIPT
const API_KEY = "你的api_key";
const url = new URL("https://open.chineselaw.com/open/rh_enterpriseWritAgg");
url.searchParams.set('id', 'a80a4cc8-9954-4dd3-bcaf-aebb99487b14');
const res = await fetch(url, {
method: "GET",
headers: {
"X-API-Key": API_KEY,
"Accept": "application/json",
},
});
if (!res.ok) throw new Error(`HTTP ${res.status}`);
console.log(await res.json());
MCP Tool 名称
| MCP Server | yuandian-company(企业信息 Server) |
|---|---|
| Streamable HTTP 入口 | https://open.chineselaw.com/mcp/company/stream |
| MCP Tool | yuandian_rh_enterpriseWritAgg |
响应示例
{
"key": "物权保护纠纷",
"count": 14
},
{
"key": "与公司有关的纠纷",
"count": 6
},
{
"key": "专利行政登记",
"count": 3
},
{
"key": "执行程序中的异议之诉",
"count": 2
},
{
"key": "监察行政处罚行政登记行政许可",
"count": 2
},
{
"key": "知识产权与竞争",
"count": 2
},
{
"key": "食品药品行政处罚行政登记行政许可",
"count": 2
},
{
"key": "专利行政处理",
"count": 1
},
{
"key": "专利行政救助行政许可行政处理",
"count": 1
},
{
"key": "仲裁程序案件",
"count": 1
},
{
"key": "劳动争议",
"count": 1
},
{
"key": "垄断纠纷",
"count": 1
}
],
"文书种类": [
{
"key": "裁定书",
"count": 4875
},
{
"key": "判决书",
"count": 2047
},
{
"key": "决定书",
"count": 1
}
],
"审判程序": [
{
"key": "一审案件",
"count": 5149
},
{
"key": "二审案件",
"count": 1004
},
{
"key": "再审审查案件",
"count": 42
},
{
"key": "普通执行",
"count": 33
},
{
"key": "再审案件",
"count": 5
},
{
"key": "非诉财产保全审查案件",
"count": 4
},
{
"key": "执行异议",
"count": 2
},
{
"key": "特别程序案件",
"count": 1
},
{
"key": "督促案件",
"count": 1
},
{
"key": "非诉行为保全审查案件",
"count": 1
}
],
"法院层级": [
{
"key": "基层",
"count": 4292
},
{
"key": "中级",
"count": 2267
},
{
"key": "高级",
"count": 349
},
{
"key": "最高",
"count": 15
}
],
"结案方式": [
{
"key": "准予撤诉",
"count": 2368
},
{
"key": "判决",
"count": 1431
},
{
"key": "维持",
"count": 654
},
{
"key": "按撤诉处理",
"count": 503
},
{
"key": "裁定移送其他法院管辖",
"count": 317
},
{
"key": "其他",
"count": 254
},
{
"key": "准予撤回起诉并撤销一审判决",
"count": 142
},
{
"key": "准予撤回上诉",
"count": 99
},
{
"key": "与本院其他案件并案审理",
"count": 32
},
{
"key": "终结本次执行",
"count": 23
},
{
"key": "按撤回上诉处理",
"count": 19
},
{
"key": "改判(含变更原判决)",
"count": 19
},
{
"key": "驳回起诉",
"count": 19
},
{
"key": "裁定驳回再审申请",
"count": 17
},
{
"key": "发回重审",
"count": 8
},
{
"key": "终结",
"count": 7
},
{
"key": "改判",
"count": 5
},
{
"key": "撤销原判并驳回起诉",
"count": 2
},
{
"key": "本院提审",
"count": 2
},
{
"key": "驳回申请",
"count": 2
}
],
"结案年份": [
{
"key": "2019",
"count": 1239
},
{
"key": "2018",
"count": 1114
},
{
"key": "2020",
"count": 1097
},
{
"key": "2017",
"count": 878
},
{
"key": "2021",
"count": 813
},
{
"key": "2022",
"count": 617
},
{
"key": "2016",
"count": 359
},
{
"key": "2023",
"count": 349
},
{
"key": "2014",
"count": 200
},
{
"key": "2015",
"count": 189
},
{
"key": "2013",
"count": 47
},
{
"key": "2024",
"count": 11
},
{
"key": "2011",
"count": 3
},
{
"key": "2008",
"count": 2
},
{
"key": "2025",
"count": 2
},
{
"key": "2012",
"count": 1
}
],
"地域": [
{
"key": "北京",
"count": 3395
},
{
"key": "广东",
"count": 1109
},
{
"key": "上海",
"count": 621
},
{
"key": "河南",
"count": 447
},
{
"key": "江苏",
"count": 325
},
{
"key": "重庆",
"count": 149
},
{
"key": "浙江",
"count": 145
},
{
"key": "湖南",
"count": 96
},
{
"key": "河北",
"count": 94
},
{
"key": "山东",
"count": 93
},
{
"key": "湖北",
"count": 59
},
{
"key": "四川",
"count": 57
},
{
"key": "陕西",
"count": 51
},
{
"key": "天津",
"count": 40
},
{
"key": "福建",
"count": 40
},
{
"key": "安徽",
"count": 37
},
{
"key": "海南",
"count": 34
},
{
"key": "辽宁",
"count": 34
},
{
"key": "江西",
"count": 29
},
{
"key": "最高",
"count": 15
}
],
"诉讼身份": [
{
"key": "应诉方",
"count": 5307
},
{
"key": "起诉方",
"count": 1541
},
{
"key": "第三方",
"count": 75
}
],
"对方当事人身份": [
{
"key": "法人",
"count": 5118
},
{
"key": "自然人",
"count": 2140
},
{
"key": "非法人组织",
"count": 352
}
]
},
"message": "请求成功",
"status": "success"
}
```
完整文档
企业涉诉信息统计接口
1. 基本信息
- 接口名称:企业涉诉信息统计接口
- 接口用途:根据企业ID或统一社会信用代码针对企业涉诉信息,统计不同维度的分布情况(案件类别、案由、文书种类、审判程序、法院层级、结案方式、结案年份、地域、诉讼身份、对手当事人身份)。
2. 请求信息
- HTTP Method:GET
- URL:
https://open.chineselaw.com/open/rh_enterpriseWritAgg
3. 请求参数(Query)
| 参数名 | 类型 | 是否必填 | 说明 |
|---|---|---|---|
id |
string | 否 | 企业ID |
tyshxydm |
string | 否 | 统一社会信用代码 |
id与tyshxydm不能同时为空。
4. 请求示例
GET https://open.chineselaw.com/open/rh_enterpriseWritAgg?id=a80a4cc8-9954-4dd3-bcaf-aebb99487b14
5. 响应说明
5.1 通用返回结构
| 字段名 | 类型 | 说明 |
|---|---|---|
status |
string | success / notFound 等 |
code |
number | 成功 200 |
message |
string | 提示信息 |
data |
object | 数据结果 |
5.2 data 对象说明(概要)
| 字段名 | 类型 | 说明 |
|---|---|---|
id |
string | 企业ID |
name |
string | 企业名称 |
total |
number | 总数 |
6. 响应示例
{
"code": 200,
"data": {
"id": "a80a4cc8-9954-4dd3-bcaf-aebb99487b14",
"name": "北京百度网讯科技有限公司",
"total": 6923,
"案件类别": [
{
"key": "民事案件",
"count": 6163
},
{
"key": "管辖案件",
"count": 680
},
{
"key": "行政案件",
"count": 44
},
{
"key": "执行案件",
"count": 35
},
{
"key": "国际司法协助案件",
"count": 1
}
],
"一级案由": [
{
"key": "知识产权与竞争纠纷",
"count": 5542
},
{
"key": "人格权纠纷",
"count": 374
},
{
"key": "合同、准合同纠纷",
"count": 368
},
{
"key": "侵权责任纠纷",
"count": 278
},
{
"key": "民事",
"count": 31
},
{
"key": "专利",
"count": 28
},
{
"key": "劳动争议、人事争议",
"count": 17
},
{
"key": "物权纠纷",
"count": 14
},
{
"key": "与公司、证券、保险、票据等有关的民事纠纷",
"count": 6
},
{
"key": "专利行政登记",
"count": 3
},
{
"key": "特殊诉讼程序案件案由",
"count": 2
},
{
"key": "监察行政处罚行政登记行政许可",
"count": 2
},
{
"key": "非讼程序案件案由",
"count": 2
},
{
"key": "食品药品行政处罚行政登记行政许可",
"count": 2
},
{
"key": "专利行政处理",
"count": 1
},
{
"key": "专利行政救助行政许可行政处理",
"count": 1
},
{
"key": "工商行政处罚",
"count": 1
},
{
"key": "监察行政处罚",
"count": 1
},
{
"key": "监察行政救助行政复议",
"count": 1
}
],
"二级案由": [
{
"key": "知识产权权属、侵权纠纷",
"count": 4775
},
{
"key": "人格权纠纷",
"count": 374
},
{
"key": "合同纠纷",
"count": 319
},
{
"key": "侵权责任纠纷",
"count": 278
},
{
"key": "不正当竞争纠纷",
"count": 46
},
{
"key": "知识产权合同纠纷",
"count": 38
},
{
"key": "专利",
"count": 28
},
{
"key": "合同、无因管理、不当得利",
"count": 26
},
{
"key": "物权保护纠纷",
"count": 14
},
{
"key": "与公司有关的纠纷",
"count": 6
},
{
"key": "专利行政登记",
"count": 3
},
{
"key": "执行程序中的异议之诉",
"count": 2
},
{
"key": "监察行政处罚行政登记行政许可",
"count": 2
},
{
"key": "知识产权与竞争",
"count": 2
},
{
"key": "食品药品行政处罚行政登记行政许可",
"count": 2
},
{
"key": "专利行政处理",
"count": 1
},
{
"key": "专利行政救助行政许可行政处理",
"count": 1
},
{
"key": "仲裁程序案件",
"count": 1
},
{
"key": "劳动争议",
"count": 1
},
{
"key": "垄断纠纷",
"count": 1
}
],
"文书种类": [
{
"key": "裁定书",
"count": 4875
},
{
"key": "判决书",
"count": 2047
},
{
"key": "决定书",
"count": 1
}
],
"审判程序": [
{
"key": "一审案件",
"count": 5149
},
{
"key": "二审案件",
"count": 1004
},
{
"key": "再审审查案件",
"count": 42
},
{
"key": "普通执行",
"count": 33
},
{
"key": "再审案件",
"count": 5
},
{
"key": "非诉财产保全审查案件",
"count": 4
},
{
"key": "执行异议",
"count": 2
},
{
"key": "特别程序案件",
"count": 1
},
{
"key": "督促案件",
"count": 1
},
{
"key": "非诉行为保全审查案件",
"count": 1
}
],
"法院层级": [
{
"key": "基层",
"count": 4292
},
{
"key": "中级",
"count": 2267
},
{
"key": "高级",
"count": 349
},
{
"key": "最高",
"count": 15
}
],
"结案方式": [
{
"key": "准予撤诉",
"count": 2368
},
{
"key": "判决",
"count": 1431
},
{
"key": "维持",
"count": 654
},
{
"key": "按撤诉处理",
"count": 503
},
{
"key": "裁定移送其他法院管辖",
"count": 317
},
{
"key": "其他",
"count": 254
},
{
"key": "准予撤回起诉并撤销一审判决",
"count": 142
},
{
"key": "准予撤回上诉",
"count": 99
},
{
"key": "与本院其他案件并案审理",
"count": 32
},
{
"key": "终结本次执行",
"count": 23
},
{
"key": "按撤回上诉处理",
"count": 19
},
{
"key": "改判(含变更原判决)",
"count": 19
},
{
"key": "驳回起诉",
"count": 19
},
{
"key": "裁定驳回再审申请",
"count": 17
},
{
"key": "发回重审",
"count": 8
},
{
"key": "终结",
"count": 7
},
{
"key": "改判",
"count": 5
},
{
"key": "撤销原判并驳回起诉",
"count": 2
},
{
"key": "本院提审",
"count": 2
},
{
"key": "驳回申请",
"count": 2
}
],
"结案年份": [
{
"key": "2019",
"count": 1239
},
{
"key": "2018",
"count": 1114
},
{
"key": "2020",
"count": 1097
},
{
"key": "2017",
"count": 878
},
{
"key": "2021",
"count": 813
},
{
"key": "2022",
"count": 617
},
{
"key": "2016",
"count": 359
},
{
"key": "2023",
"count": 349
},
{
"key": "2014",
"count": 200
},
{
"key": "2015",
"count": 189
},
{
"key": "2013",
"count": 47
},
{
"key": "2024",
"count": 11
},
{
"key": "2011",
"count": 3
},
{
"key": "2008",
"count": 2
},
{
"key": "2025",
"count": 2
},
{
"key": "2012",
"count": 1
}
],
"地域": [
{
"key": "北京",
"count": 3395
},
{
"key": "广东",
"count": 1109
},
{
"key": "上海",
"count": 621
},
{
"key": "河南",
"count": 447
},
{
"key": "江苏",
"count": 325
},
{
"key": "重庆",
"count": 149
},
{
"key": "浙江",
"count": 145
},
{
"key": "湖南",
"count": 96
},
{
"key": "河北",
"count": 94
},
{
"key": "山东",
"count": 93
},
{
"key": "湖北",
"count": 59
},
{
"key": "四川",
"count": 57
},
{
"key": "陕西",
"count": 51
},
{
"key": "天津",
"count": 40
},
{
"key": "福建",
"count": 40
},
{
"key": "安徽",
"count": 37
},
{
"key": "海南",
"count": 34
},
{
"key": "辽宁",
"count": 34
},
{
"key": "江西",
"count": 29
},
{
"key": "最高",
"count": 15
}
],
"诉讼身份": [
{
"key": "应诉方",
"count": 5307
},
{
"key": "起诉方",
"count": 1541
},
{
"key": "第三方",
"count": 75
}
],
"对方当事人身份": [
{
"key": "法人",
"count": 5118
},
{
"key": "自然人",
"count": 2140
},
{
"key": "非法人组织",
"count": 352
}
]
},
"message": "请求成功",
"status": "success"
}
7. 代码示例
7.1 CURL
curl --location --request GET 'https://open.chineselaw.com/open/rh_enterpriseWritAgg?id=a80a4cc8-9954-4dd3-bcaf-aebb99487b14' \
--header 'X-API-Key: 你的api_key' \
--header 'Accept: application/json'
7.2 Python
import requests
url = "https://open.chineselaw.com/open/rh_enterpriseWritAgg"
API_KEY = "你的api_key"
headers = {
"X-API-Key": API_KEY,
"Accept": "application/json",
}
params = {
'id': 'a80a4cc8-9954-4dd3-bcaf-aebb99487b14',
}
response = requests.get(url, params=params, headers=headers, timeout=60)
response.raise_for_status()
print(response.json())
7.3 Java
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.time.Duration;
public class EnterpriseWritAggExample {
public static void main(String[] args) throws Exception {
String apiKey = "你的api_key";
String url = "https://open.chineselaw.com/open/rh_enterpriseWritAgg?id=a80a4cc8-9954-4dd3-bcaf-aebb99487b14";
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create(url))
.timeout(Duration.ofSeconds(60))
.header("X-API-Key", apiKey)
.header("Accept", "application/json")
.GET()
.build();
HttpClient client = HttpClient.newHttpClient();
HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.statusCode());
System.out.println(response.body());
}
}
7.4 JavaScript
const API_KEY = "你的api_key";
const url = new URL("https://open.chineselaw.com/open/rh_enterpriseWritAgg");
url.searchParams.set('id', 'a80a4cc8-9954-4dd3-bcaf-aebb99487b14');
const res = await fetch(url, {
method: "GET",
headers: {
"X-API-Key": API_KEY,
"Accept": "application/json",
},
});
if (!res.ok) throw new Error(`HTTP ${res.status}`);
console.log(await res.json());