Enterprise Annual Report Details API

# Enterprise Annual Report Details API

Retrieve structured details of an enterprise annual report for a specified year using the enterprise ID or unified social credit code and the reporting year. Details include basic information, shareholder capital contributions, websites and online stores, assets, external investments, and external guarantees. Use the Enterprise Basic Information API to check which reporting years are available.
## Available implementations
yuandian · Enterprise Annual Report Details API: https://openany.si/markets/apis/capabilities/yuandian-enterprise-annual-report-details-api?offering=01dcc2b9-a6bc-426e-8138-21fb1f826fe3 · $0 / call

## Selected API contract
Documentation: https://openany.si/markets/apis/capabilities/yuandian-enterprise-annual-report-details-api
Method: GET
Endpoint: https://api.openany.si/v1/agent-apis/yuandian/open/rh_enterpriseAnnualReport
Price: $0 / call
Provider: yuandian
Contract revision: 2
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/yuandian/open/rh_enterpriseAnnualReport?id=a80a4cc8-9954-4dd3-bcaf-aebb99487b14&year=2023' \
  -X GET \
  -H "Authorization: Bearer $OPENANY_API_KEY" \
  -H 'Content-Type: application/json'
```

## API contract
```json
{
  "resource_type": "api",
  "name": "Enterprise Annual Report Details API",
  "endpoint": "https://api.openany.si/v1/agent-apis/yuandian/open/rh_enterpriseAnnualReport",
  "method": "GET",
  "content_type": "none",
  "execution_mode": "sync",
  "authentication": {
    "type": "bearer",
    "environment_variable": "OPENANY_API_KEY"
  },
  "inputs": [
    {
      "description": "Enterprise ID",
      "location": "query",
      "name": "id",
      "nullable": false,
      "required": false,
      "type": "string"
    },
    {
      "description": "Unified social credit code",
      "location": "query",
      "name": "tyshxydm",
      "nullable": false,
      "required": false,
      "type": "string"
    },
    {
      "description": "Annual report year (corresponding to ES `reportYear`)",
      "location": "query",
      "name": "year",
      "nullable": false,
      "required": true,
      "type": "string"
    }
  ],
  "billing": {
    "currency": "USD",
    "mode": "fixed",
    "priceMicroUsd": "0",
    "rounding": null,
    "unit": "call",
    "unitQuantity": null
  },
  "examples": [
    {
      "http_status": 200,
      "name": "Documentation example (HTTP status set during import)",
      "request": {
        "body": null,
        "headers": {},
        "path": {},
        "query": {
          "id": "a80a4cc8-9954-4dd3-bcaf-aebb99487b14",
          "year": "2023"
        }
      },
      "response_body": {
        "code": 200,
        "data": {
          "id": "a80a4cc8-9954-4dd3-bcaf-aebb99487b14",
          "name": "示例科技有限公司",
          "企业基本信息": {
            "从业人数": "企业选择不公示",
            "企业名称": "示例科技有限公司",
            "企业经营状态": "开业",
            "企业通信地址": "北京市海淀区示例路1号",
            "企业邮箱": "企业选择不公示",
            "工商注册号": "110000000000001",
            "统一社会信用代码": "91110000000000000X",
            "联系电话": "010-12345678"
          },
          "企业资产信息": {
            "主营业务收入": "企业选择不公示",
            "净利润": "企业选择不公示",
            "利润总额": "企业选择不公示",
            "所有者权益合计": "企业选择不公示",
            "纳税总额": "企业选择不公示",
            "负债总额": "企业选择不公示",
            "资产总额": "企业选择不公示",
            "销售总额（营业总收入）": "企业选择不公示"
          },
          "对外投资信息": [],
          "对外担保信息": [],
          "网站或网店信息": [],
          "股东及出资信息": []
        },
        "message": "请求成功",
        "status": "success"
      }
    }
  ]
}
```