# 企业法律诉讼查询API

**请求方式：** GET

**接口地址：** https://v2.xxapi.cn/api/lawsuit

**接口描述：** 免费API提供专业的企业法律诉讼信息查询服务，支持通过公司名称、企业ID、统一社会信用代码等方式快速获取企业相关法律诉讼及司法案件数据。接口可返回案号、案件名称、案由、案件金额、案件身份、裁判结果标签、审理法院、立案时间、案件进度、判决结果等详细字段信息，帮助用户全面掌握企业涉诉情况与司法风险状态。适用于企业信用评估、商业合作背景调查、供应商风险管理、金融风控、投资尽职调查、贷前审核及企业合规审查等多种业务场景。接口支持高并发访问、实时数据更新、多格式输出，确保法律诉讼查询结果的准确性、完整性与稳定性，为企业风险识别与信用管理提供可靠的数据支持。

## 请求参数

| 参数名 | 可传值说明 | 传入位置 | 是否必填 | 示例值 | 默认值 | 参数说明 |
|--------|----------|----------|----------|--------|--------|----------|
| keyword | 公司名称、社会统一信用代码 | query | 必传 | — | — | 搜索关键字（公司名称、社会统一信用代码） |
| pageNum | 页数 | query | 可选 | — | — | 当前页数（默认第1页） |
| pageSize | 条数 | query | 可选 | — | — | 每页条数（默认20条，最大20条） |
| brief | 案件案由 | query | 可选 | — | — | 案件案由（法律诉讼的对应案由，通过关键词进行搜索） |
| Authorization | Bearer <access_key> | header | 必传 | Bearer <access_key> | — | 请登录后前往控制面板查询 API Key |

## 返回示例

```json
{
  "code": 200, 
  "msg": "数据请求成功", 
  "data": {
    "items": [
      {
        "id": 379318446, // 对应表 ID
        "caseMoney": "", // 案件金额（为空表示暂无数据）
        "submitTime": 1768838400000, // 发布日期时间戳（毫秒）
        "docType": "判决书", // 文书类型
        "lawsuitUrl": "https://www.tianyancha.com/lawsuit/xxx", // 天眼查 Web 端链接
        "lawsuitH5Url": "https://m.tianyancha.com/app/h5/lawsuit/xxx", // 天眼查 H5 / 移动端链接
        "uuid": "a5b118677f2847798568ad56d845469c", // 案件唯一 UUID
        "title": "北京某乙有限公司等与上海某甲有限公司侵害作品信息网络传播权纠纷一审民事判决书", // 案件标题 / 文书名称
        "court": "上海市浦东新区人民法院", // 审理法院
        "judgeTime": "2026-01-08", // 裁判日期
        "caseNo": "（2025）沪0115民初111005号", // 案号
        "caseType": "民事案件", // 案件类型
        "caseReason": "侵害作品信息网络传播权纠纷", // 案由
        "casePersons": [
          {
            "role": "原告", // 当事人身份（原告 / 被告 / 第三人等）
            "type": "2", // 类型：1 = 自然人；2 = 公司
            "name": "某有限公司", // 当事人名称
            "gid": "3131650720", // 企业 / 人员对应 ID
            "result": "撤诉", // 判决结果标签
            "emotion": 0, // 情感倾向：1 = 正面 0 = 中性 -1 = 负面
            "sptname": "" // 疑似名称（可能用于企业名称匹配）
          }
        ]
      }
    ],
    "total": 1
  },
  "request_id": "beeea5b9cf0eb22103a934bb" 
}
```