Ownership API — API reference

Unifies 5%-rule and acquisition disclosures from Korea (OpenDART), Japan (EDINET), China (CNINFO), Hong Kong (HKEX), Taiwan (TWSE), and US (SEC EDGAR ADRs) into a single ownership graph. Cross-lingual entity linking via Hannune's Entity Resolution canonical IDs. Daily polling.

Base URL

https://api.hannune.ai/ownership/v1

Authentication

All requests require an API key as a Bearer token. Create a key in your dashboard.

Authorization: Bearer erk_live_xxxxxxxxxxxxxxxx

Ownership tree

GET /companies/{identifier}/ownership-tree — ownership chain up to depth 4. identifier = ER API canonical id (e.g. company_545e7582).

curl "https://api.hannune.ai/ownership/v1/companies/company_xxx/ownership-tree?depth=3&direction=owners" \
  -H "Authorization: Bearer $API_KEY"

Parameters: depth (1-4), direction (owners | owns | both), id_kind (er | node).

Ownership history (time series)

GET /companies/{identifier}/ownership-history — append-only history of every reported ownership change with evidence quotes from primary disclosures.

curl "https://api.hannune.ai/ownership/v1/companies/company_xxx/ownership-history?role=both&limit=200" \
  -H "Authorization: Bearer $API_KEY"

Graph stats

GET /stats — total companies, persons, and relations currently in the graph.

curl https://api.hannune.ai/ownership/v1/stats -H "Authorization: Bearer $API_KEY"

Plans & limits

Errors

• 401 — missing or invalid API key.
• 402 — monthly quota exceeded. Upgrade your plan to continue.
• 429 — rate limit exceeded. Retry after a short delay.