{"openapi":"3.1.0","info":{"title":"KR Entity Crosswalk","version":"0.1.0","description":"Resolve any Korean company identifier (name in Korean/English incl. former names, 사업자등록번호, 법인등록번호, OpenDART corp_code, stock code, LEI) to one canonical entity with all known IDs and a 0-1 match confidence with reasons. Data: OpenDART corpCode/company, GLEIF LEI records; optional live NTS status via kr-utils."},"servers":[{"url":"https://entity.pokt-agent.com"}],"paths":{"/v1/resolve":{"post":{"summary":"Resolve up to 100 identifiers","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["items"],"properties":{"items":{"type":"array","maxItems":100,"items":{"type":"object","description":"Give at least one field. `q` accepts any identifier and auto-detects its kind (10 digits = bizr_no, 13 = jurir_no, 8 = corp_code, 6 = stock_code, 20-char LEI, otherwise a name).","properties":{"q":{"type":"string"},"name":{"type":"string","description":"Korean or English name; legal forms (주식회사, ㈜, (주), Co., Ltd., Inc., Corp.) and spacing are ignored; former names match too"},"bizr_no":{"type":"string","description":"사업자등록번호, 10 digits (hyphens allowed); check digit is verified"},"jurir_no":{"type":"string","description":"법인등록번호, 13 digits (hyphens allowed); check digit is verified"},"corp_code":{"type":"string","pattern":"^\\d{8}$","description":"OpenDART corp_code"},"stock_code":{"type":"string","pattern":"^[0-9A-Z]{6}$"},"lei":{"type":"string","pattern":"^[0-9A-Z]{20}$","description":"ISO 17442 LEI; mod-97 check is verified"}}}},"limit_candidates":{"type":"integer","minimum":0,"maximum":10,"default":3},"enrich":{"type":"boolean","default":false,"description":"Attach live National Tax Service status (match.nts) for matched entities with a bizr_no"}}}}}},"responses":{"200":{"description":"Per item: status (MATCHED | AMBIGUOUS | LOW_CONFIDENCE | NO_MATCH | CONFLICT | INVALID), match (null unless MATCHED), confidence 0-1, reasons[], candidates[]. match requires confidence >= 0.8 and no runner-up within 0.05."},"400":{"description":"Bad request"}}},"get":{"summary":"Resolve one identifier","parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string"}},{"name":"limit_candidates","in":"query","schema":{"type":"integer"}},{"name":"enrich","in":"query","schema":{"type":"boolean"}}]}},"/v1/entity/{id}":{"get":{"summary":"Entity record by entity_id (or by any unambiguous identifier)","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"enrich","in":"query","schema":{"type":"boolean"}}]}},"/v1/health":{"get":{"summary":"Readiness"}},"/v1/version":{"get":{"summary":"Version and dataset metadata"}}}}