API DETAIL

企业年报详情接口

根据企业 ID 或统一社会信用代码及年报年份，查询该年度企业年报结构化详情（基本信息、股东出资、网站网店、资产、对外投资、对外担保等），有哪些年度有年报可以通过企业基本信息接口查看。

分类：企业信息方法：GET MCP Tool：yuandian_rh_enterpriseAnnualReport

首屏摘要

接口名称	企业年报详情接口
接口描述	根据企业 ID 或统一社会信用代码及年报年份，查询该年度企业年报结构化详情（基本信息、股东出资、网站网店、资产、对外投资、对外担保等），有哪些年度有年报可以通过企业基本信息接口查看。
分类	企业信息
调用地址	`https://open.chineselaw.com/open/rh_enterpriseAnnualReport`
文档摘要	企业年报详情接口 1. 基本信息接口名称：企业年报详情接口用途：根据企业 ID 或统一社会信用代码及年报年份，查询该年度企业年报结构化详情（基本信息、股东出资、网站网店、资产、对外投资、对外担保等），有哪些年度有年报可以通过企业基本信息接口查看。 2. 请求信息 HTTP Method：GET URL：/legal-insight/service/app/dify/company/enterpriseAnnualReport 3. 请求参…

请求参数

3. 请求参数（Query）

参数名	类型	是否必填	说明
`id`	string	否	企业 ID
`tyshxydm`	string	否	统一社会信用代码
`year`	string	是	年报年份（对应 ES `reportYear`）

id 与 tyshxydm 不能同时为空。

响应参数

5. 响应说明

返回类型：JSON 字符串
成功/失败判断：看 status 与 code
code说明

code 说明

200 接口调用成功

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

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	企业名称
`企业基本信息`	object	年报中的企业联系与状态等
`股东及出资信息`	object[]	股东及认缴/实缴出资
`网站或网店信息`	object[]	网站或网店
`企业资产信息`	object	资产、利润、负债等
`对外投资信息`	object[]	年报披露的对外投资
`对外担保信息`	object[]	对外担保

错误码

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

调用示例

CURL

curl --location --request GET '/legal-insight/service/app/dify/company/enterpriseAnnualReport?id=a80a4cc8-9954-4dd3-bcaf-aebb99487b14&year=2023' \
--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 EnterpriseAnnualReportExample {
    public static void main(String[] args) throws Exception {
        String apiKey = "你的api_key";
        String url = "/legal-insight/service/app/dify/company/enterpriseAnnualReport?id=a80a4cc8-9954-4dd3-bcaf-aebb99487b14&year=2023";

        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 = "/legal-insight/service/app/dify/company/enterpriseAnnualReport"
API_KEY = "你的api_key"
headers = {
    "X-API-Key": API_KEY,
    "Accept": "application/json",
}
params = {
    'id': 'a80a4cc8-9954-4dd3-bcaf-aebb99487b14',
    'year': '2023',
}
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("/legal-insight/service/app/dify/company/enterpriseAnnualReport");
url.searchParams.set('id', 'a80a4cc8-9954-4dd3-bcaf-aebb99487b14');
url.searchParams.set('year', '2023');

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_enterpriseAnnualReport`

响应示例

{
  "code": 200,
  "data": {
    "id": "a80a4cc8-9954-4dd3-bcaf-aebb99487b14",
    "name": "示例科技有限公司",
    "企业基本信息": {
      "企业名称": "示例科技有限公司",
      "工商注册号": "110000000000001",
      "统一社会信用代码": "91110000000000000X",
      "企业经营状态": "开业",
      "从业人数": "企业选择不公示",
      "联系电话": "010-12345678",
      "企业邮箱": "企业选择不公示",
      "企业通信地址": "北京市海淀区示例路1号"
    },
    "股东及出资信息": [],
    "网站或网店信息": [],
    "企业资产信息": {
      "资产总额": "企业选择不公示",
      "所有者权益合计": "企业选择不公示",
      "销售总额（营业总收入）": "企业选择不公示",
      "主营业务收入": "企业选择不公示",
      "利润总额": "企业选择不公示",
      "净利润": "企业选择不公示",
      "纳税总额": "企业选择不公示",
      "负债总额": "企业选择不公示"
    },
    "对外投资信息": [],
    "对外担保信息": []
  },
  "message": "请求成功",
  "status": "success"
}

完整文档

企业年报详情接口

1. 基本信息

接口名称：企业年报详情
接口用途：根据企业 ID 或统一社会信用代码及年报年份，查询该年度企业年报结构化详情（基本信息、股东出资、网站网店、资产、对外投资、对外担保等），有哪些年度有年报可以通过企业基本信息接口查看。

2. 请求信息

HTTP Method：GET
URL：/legal-insight/service/app/dify/company/enterpriseAnnualReport

3. 请求参数（Query）

参数名	类型	是否必填	说明
`id`	string	否	企业 ID
`tyshxydm`	string	否	统一社会信用代码
`year`	string	是	年报年份（对应 ES `reportYear`）

id 与 tyshxydm 不能同时为空。

4. 请求示例

GET /legal-insight/service/app/dify/company/enterpriseAnnualReport?id=a80a4cc8-9954-4dd3-bcaf-aebb99487b14&year=2023

5. 响应说明

返回类型：JSON 字符串
成功/失败判断：看 status 与 code
code说明

code 说明

200 接口调用成功

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

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	企业名称
`企业基本信息`	object	年报中的企业联系与状态等
`股东及出资信息`	object[]	股东及认缴/实缴出资
`网站或网店信息`	object[]	网站或网店
`企业资产信息`	object	资产、利润、负债等
`对外投资信息`	object[]	年报披露的对外投资
`对外担保信息`	object[]	对外担保

6. 响应示例

{
  "code": 200,
  "data": {
    "id": "a80a4cc8-9954-4dd3-bcaf-aebb99487b14",
    "name": "示例科技有限公司",
    "企业基本信息": {
      "企业名称": "示例科技有限公司",
      "工商注册号": "110000000000001",
      "统一社会信用代码": "91110000000000000X",
      "企业经营状态": "开业",
      "从业人数": "企业选择不公示",
      "联系电话": "010-12345678",
      "企业邮箱": "企业选择不公示",
      "企业通信地址": "北京市海淀区示例路1号"
    },
    "股东及出资信息": [],
    "网站或网店信息": [],
    "企业资产信息": {
      "资产总额": "企业选择不公示",
      "所有者权益合计": "企业选择不公示",
      "销售总额（营业总收入）": "企业选择不公示",
      "主营业务收入": "企业选择不公示",
      "利润总额": "企业选择不公示",
      "净利润": "企业选择不公示",
      "纳税总额": "企业选择不公示",
      "负债总额": "企业选择不公示"
    },
    "对外投资信息": [],
    "对外担保信息": []
  },
  "message": "请求成功",
  "status": "success"
}

7. 代码示例

7.1 CURL

curl --location --request GET '/legal-insight/service/app/dify/company/enterpriseAnnualReport?id=a80a4cc8-9954-4dd3-bcaf-aebb99487b14&year=2023' \
--header 'X-API-Key: 你的api_key' \
--header 'Accept: application/json'

7.2 Python

import requests

url = "/legal-insight/service/app/dify/company/enterpriseAnnualReport"
API_KEY = "你的api_key"
headers = {
    "X-API-Key": API_KEY,
    "Accept": "application/json",
}
params = {
    'id': 'a80a4cc8-9954-4dd3-bcaf-aebb99487b14',
    'year': '2023',
}
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 EnterpriseAnnualReportExample {
    public static void main(String[] args) throws Exception {
        String apiKey = "你的api_key";
        String url = "/legal-insight/service/app/dify/company/enterpriseAnnualReport?id=a80a4cc8-9954-4dd3-bcaf-aebb99487b14&year=2023";

        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("/legal-insight/service/app/dify/company/enterpriseAnnualReport");
url.searchParams.set('id', 'a80a4cc8-9954-4dd3-bcaf-aebb99487b14');
url.searchParams.set('year', '2023');

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

企业年报详情接口

首屏摘要

请求参数

3. 请求参数（Query）

响应参数

5. 响应说明

5.1 通用返回结构

5.2 data 对象说明

错误码

调用示例

CURL

JAVA

PYTHON

JAVASCRIPT

MCP Tool 名称

响应示例

完整文档

企业年报详情接口

1. 基本信息

2. 请求信息

3. 请求参数（Query）

4. 请求示例

5. 响应说明

5.1 通用返回结构

5.2 data 对象说明

6. 响应示例

7. 代码示例

7.1 CURL

7.2 Python

7.3 Java

7.4 JavaScript

5.2 `data` 对象说明

5.2 `data` 对象说明