STATIC API DOCUMENT

企业涉诉信息统计接口 API 文档

根据企业ID或统一社会信用代码针对企业涉诉信息，统计不同维度的分布情况（案件类别、案由、文书种类、审判程序、法院层级、结案方式、结案年份、地域、诉讼身份、对手当事人身份）

接口详情页 分类：企业信息 MCP Tool：yuandian_rh_enterpriseWritAgg

接口概览

接口名称企业涉诉信息统计接口
接口描述根据企业ID或统一社会信用代码针对企业涉诉信息，统计不同维度的分布情况（案件类别、案由、文书种类、审判程序、法院层级、结案方式、结案年份、地域、诉讼身份、对手当事人身份）
接口分类企业信息
调用地址https://open.chineselaw.com/open/rh_enterpriseWritAgg
请求方式GET

请求参数

3. 请求参数（Query）

参数名 类型 是否必填 说明
id string 否 企业ID
tyshxydm string 否 统一社会信用代码

id 与 tyshxydm 不能同时为空。

响应参数

5. 响应说明

  • 返回类型：JSON 字符串

  • 成功/失败判断：看 status 与 code

  • code说明

    code 说明
    200 接口调用成功
    500 参数校验/程序内部异常，具体描述见message信息

5.1 通用返回结构

字段名 类型 说明
status string success / notFound 等
code number 成功 200
message string 提示信息
data object 数据结果

5.2 data 对象说明（概要）

字段名 类型 说明
id string 企业ID
name string 企业名称
total number 总数

错误码

错误码说明
500参数校验/程序内部异常，具体描述见message信息

调用示例

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 Serveryuandian-company（企业信息 Server）
Streamable HTTP 入口https://open.chineselaw.com/mcp/company/stream
MCP Toolyuandian_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. 响应说明

  • 返回类型：JSON 字符串

  • 成功/失败判断：看 status 与 code

  • code说明

    code 说明
    200 接口调用成功
    500 参数校验/程序内部异常，具体描述见message信息

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());