企业实体（LEI）

在 GLEIF 全球 LEI 索引中按 LEI 精确查找或按法定名称搜索法人实体，返回 LEI、法定名称、状态、注册地、法律形式和地址。

接口	POST /v1/legal-entity-lookups
所需权限	legal_entity:lookup
MCP 工具	legal_entity
计量单位	entities

计量单位出现在 execution.usage.units 中，用于对账和计费。

请求字段

字段	类型	必填	说明
invocation_id	string	是	调用方（市场）生成的调用 ID：同一个 ID 在同一操作上只执行一次，用同一 ID 重试会被拒绝而不会重复计费。1–128 个字符，可用 A-Z a-z 0-9 . _ : -。
provider	string	是	处理本次请求的数据源，按下方数据源表的覆盖范围选择。 可选值：gleif
lei	string	否	20 位 ISO 17442 法人识别编码；lei 和 name 必须且只能填一个。
max_results	integer	否	按名称搜索时返回的数量，1–10，默认 5；按 lei 查找时忽略。
name	string	否	要搜索的法定名称，2–200 个字符；lei 和 name 必须且只能填一个。

数据源

数据源	区域	说明	限制
gleif	DE	GLEIF 全球 LEI 索引	max_results: 10, timeout_seconds: 30

示例

curl

curl -sS https://services.zgi.im/v1/legal-entity-lookups \
  -H "Authorization: Bearer $ZGI_SERVICES_TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{"invocation_id": "docs-1791778521-legal_entity", "provider": "gleif", "name": "Apple Inc.", "max_results": 1}'

HTTP

POST /v1/legal-entity-lookups HTTP/1.1
Host: services.zgi.im
Authorization: Bearer <token>
Content-Type: application/json

{
  "invocation_id": "docs-1791778521-legal_entity",
  "provider": "gleif",
  "name": "Apple Inc.",
  "max_results": 1
}

MCP

通过 MCP 调用时，工具参数与 HTTP 请求体完全相同。

request.json

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "legal_entity",
    "arguments": {
      "invocation_id": "docs-1791778521-legal_entity",
      "provider": "gleif",
      "name": "Apple Inc.",
      "max_results": 1
    }
  }
}

curl -sS https://services.zgi.im/v1/mcp \
  -H "Authorization: Bearer $ZGI_SERVICES_TOKEN" \
  -H 'Content-Type: application/json' -H 'Accept: application/json, text/event-stream' \
  -H 'MCP-Protocol-Version: 2025-11-25' \
  -d @request.json

返回

以下为一次真实调用的返回，列表只保留前两项，长文本已截断。

{
  "code": 0,
  "message": "success",
  "data": {
    "execution": {
      "id": "exe_01a12e52aeec72ff8a6ad9547fd490dd",
      "invocation_id": "docs-1791778521-legal_entity",
      "capability": "legal_entity",
      "operation": "legal_entity.lookup",
      "provider": "gleif",
      "outcome": "succeeded",
      "error_category": null,
      "error_code": null,
      "usage": {
        "provider_requests": 1,
        "units": [
          {
            "name": "entities",
            "value": 1,
            "source": "measured"
          }
        ]
      },
      "upstream_ref": null,
      "request_id": "req_4fe3797ca835d201ac7d92bd",
      "started_at": "2026-10-12T04:15:33.10019336Z",
      "finished_at": "2026-10-12T04:15:33.626863142Z",
      "duration_ms": 526
    },
    "result": {
      "total_results": 26,
      "entities": [
        {
          "lei": "HWUPKR0MPOU8FGXBT394",
          "legal_name": "Apple Inc.",
          "entity_status": "ACTIVE",
          "jurisdiction": "US-CA",
          "legal_form": "H1UM",
          "registration_status": "ISSUED",
          "last_updated": "2026-03-03T16:34:33Z",
          "next_renewal": "2027-03-08T17:27:20Z",
          "legal_address": {
            "lines": [
              "C/O C T Corporation System",
              "330 N. Brand Blvd"
            ],
            "city": "Glendale",
            "region": "US-CA",
            "country": "US",
            "postal_code": "91203"
          },
          "headquarters_address": {
            "lines": [
              "One Apple Park Way"
            ],
            "city": "Cupertino",
            "region": "US-CA",
            "country": "US",
            "postal_code": "95014"
          }
        }
      ],
      "source": {
        "name": "GLEIF Global LEI Index",
        "license": "CC0-1.0",
        "url": "https://www.gleif.org"
      }
    }
  }
}