China LEI Entity Change Monitor

Monitor legal-entity, LEI-registration, and published parent-relationship changes for mainland China and Hong Kong using the official GLEIF API. It is designed for scheduled compliance, counterparty, vendor, and portfolio workflows that need a durable baseline rather than an unbounded company scraper.

What it does

• accepts exact LEIs, bounded entity-name searches, or a bounded CN/HK country query;
• reads only https://api.gleif.org/api/v1 — no API key or proxy is required;
• captures legal and alternate names, entity/registration status, renewal dates, LOU, conformity, and published direct/ultimate parents;
• persists a private baseline scoped by watchName + LEI;
• distinguishes new, change, replay, no_change, no_match, and source_error without silently converting failures to empty results.

This is not a sanctions check, beneficial-ownership determination, credit decision, or complete company registry. A GLEIF reporting exception means a parent relationship may legitimately be unavailable.

Quick start

{
  "countries": ["CN"],
  "names": ["Bank of China"],
  "nameMatchMode": "fuzzy",
  "includeRelationships": true,
  "replayBaseline": false,
  "maxResults": 10,
  "maxConcurrency": 3,
  "watchName": "china-lei-watch"
}

Use the same watchName on later scheduled runs. Exact LEI lookups remain constrained to the selected country list. Name searches use GLEIF matching; exact mode additionally requires a normalized legal, alternate, or transliterated-name equality check. The Actor never accepts arbitrary URLs.

Result and baseline semantics

changeType	Meaning	Baseline action	PPE item
new	First confirmed snapshot for this watch	Written only after paid row delivery	Yes
change	Canonical snapshot differs	Advanced only after paid row delivery	Yes
replay	Unchanged snapshot, explicitly requested	Preserved	Yes
no_change	Unchanged scheduled check	Preserved	No
no_match	Valid official response confirms no matching record	Preserved	No
source_error	Transport, HTTP, JSON, schema, or relationship failure	Preserved; run fails	No

The Dataset default item event must resolve to numeric exact zero. The entity-checked event and run-start event must match the same approved contract tier and are never string-coerced. A mutex serializes strict budget checks and delivery/charge calls under concurrent fetches. Caps and spend must be finite nonnegative numbers, except the explicitly contracted unlimited cap (Infinity). A paid row is confirmed only by a finite numeric chargedCount >= 1; otherwise processing fails and no affected baseline is written.

Output

Each Dataset row includes runtime GLEIF source name, CC0 license, and terms URL in addition to its entity/no-match/error fields. Successful entity rows include LEI, legal name, country, entity and registration status, changed fields, previous/current snapshots, optional parent relationships, Golden Copy publication date, official record URL, and observation time. The terminal OUTPUT key-value-store record includes terminal, status, counters, billing event, runtime attribution, error, storage IDs, and completion time.

Limits and responsible use

• Countries: CN and optionally HK only.
• Up to 20 LEIs, 20 names, 100 unique results, and concurrency 1–5.
• Public official data only; no proxy, browser session, credential, buyer token, dynamic Actor ID, or child Actor.
• Data freshness and completeness follow the GLEIF Golden Copy and the submitting LEI issuers.

Data source, license, and independence

Entity data comes from the official GLEIF API. GLEIF makes LEI data available under the Creative Commons CC0 1.0 dedication. Source rows include attribution for traceability even though CC0 does not require it.

This independent Actor is not affiliated with, sponsored by, or endorsed by the Global Legal Entity Identifier Foundation. It does not use GLEIF branding or logos.

中文简介

本 Actor 通过 GLEIF 官方 API 监控中国大陆（CN）及可选香港（HK）的 LEI 主体、注册状态和已公布的母公司关系变化。无需 API 密钥或代理。请在定时任务中保持相同的 watchName，以便比较历史基线。no_match 表示官方响应确认无匹配；网络、HTTP 或数据结构错误会输出 source_error 并使运行失败，不会伪装成空结果。数据采用 CC0 1.0；本 Actor 与 GLEIF 无隶属或背书关系。

Local verification

npm ci
npm test
npm audit --omit=dev
npm run probe:live

The deterministic tests never use the network. Their 40-case raw JSON:API corpus covers 20 CN entities, 8 HK entities, 4 relationships, 4 normalized exact alias searches, 2 lapsed registrations, and 2 adversarial identity/schema responses. Fuzzy mode is delegated to the official GLEIF name-search endpoint; this Actor does not claim a separate client-side fuzzy scorer. probe:live is an intentionally separate, read-only check of current official API compatibility.