# Korea Company Intelligence (Resolve)

> Korea Company Intelligence (Resolve) is a paid API for AI agents from 1gateway.dev, paid per call via x402, $0.002/call, status unknown (last checked 2026-10-29).

Resolves a South Korean company by stock code, DART code, business registration number, or name into a stable companyId with Korean/English names and registry cross-references.

## Facts

- Endpoint: GET https://1gateway.dev/v1/kr/company/resolve?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-29
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/korea-company-intelligence-resolve-ef36ea9a
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_yfBLjRxDaLyH3wyuAgKH4

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability korea-company-intelligence-resolve-ef36ea9a
```

Example prompt: Can you resolve the Korean company with stock code 005930 and give me its stable companyId, DART corp code, and English name?

## When to prefer this

Use this endpoint when you need to identify or canonicalize a South Korean company before performing downstream lookups (DART filings, KONEPS procurement records, financial data). It is the right choice when you have any one of: a KRX stock code, a DART corp code, a Korean business registration number, or a company name, and need to resolve it to a stable cross-registry identifier. Prefer this over general web search when you need a structured, machine-readable result with high confidence from authoritative Korean regulatory sources.

## Known failure modes

- No company found for the given input — returns empty companies array with count 0
- Ambiguous name match — ambiguous flag set to true with multiple company candidates returned
- Invalid business registration number format — 400 bad request
- Invalid stock code format (not 6 alphanumeric chars) — 400 validation error
- Company exists in KRX but not registered in DART — partial data returned
- Payment not made or x402 auth failure — 402 Payment Required

## How this service works

Use when an agent must identify a South Korean company before looking up its profile or public-procurement record. Input: one of business_number (10 digits), dart_corp_code, stock_code (KRX, e.g. 005930) or q (company name, exact match ignoring 주식회사/(주)/spacing); first wins. Output: JSON companies with stable companyId, Korean and English names, stock code, DART code, match type, ambiguous flag. Data: OpenDART, KONEPS. Example: ?stock_code=005930

## Output

A JSON object containing: the original query parameters echoed back, a count of matched companies, an ambiguous boolean flag, and an array of company records each with a stable companyId (e.g. kr-dart-00126380), Korean name, English name, KRX stock code, DART corp code, business registration number, match type (e.g. stock_code, name, business_number), and confidence score. Also includes data sources with retrieval timestamps and attribution strings from OpenDART.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [],
     "properties": {
      "q": {
       "type": "string",
       "examples": [
        "삼성전자"
       ],
       "maxLength": 100,
       "description": "Company name (Korean or English), matched exactly after removing legal-form words"
      },
      "stock_code": {
       "type": "string",
       "pattern": "^[0-9A-Za-z]{6}$",
       "examples": [
        "005930"
       ],
       "description": "KRX stock code"
      },
      "dart_corp_code": {
       "type": "string",
       "pattern": "^\\d{8}$",
       "examples": [
        "00126380"
       ],
       "description": "OpenDART corp_code (8 digits)"
      },
      "business_number": {
       "type": "string",
       "pattern": "^\\d{3}-?\\d{2}-?\\d{5}$",
       "examples": [
        "1248100998"
       ],
       "maxLength": 12,
       "description": "Business registration number (사업자등록번호), 10 digits"
      }
     },
     "additionalProperties": false
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "required": [
      "query",
      "count",
      "ambiguous",
      "companies",
      "sources",
      "attribution",
      "note"
     ],
     "properties": {
      "note": {
       "type": "string"
      },
      "count": {
       "type": "integer"
      },
      "query": {
       "type": "object",
       "properties": {
        "q": {
         "type": [
          "string",
          "null"
         ]
        },
        "stockCode": {
         "type": [
          "string",
          "null"
         ]
        },
        "dartCorpCode": {
         "type": "null"
        },
        "businessNumber": {
         "type": [
          "string",
          "null"
         ]
        }
       }
      },
      "sources": {
       "type": "array",
       "items": {
        "type": "object",
        "properties": {
         "provider": {
          "type": "string"
         },
         "retrievedAt": {
          "ty
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "note": "companyId is stable: kr-dart-<DART corp_code> for DART-registered companies, kr-brn-<business number> otherwise. A business number is linked to DART only when …",
  "count": 1,
  "query": {
   "q": null,
   "stockCode": "005930",
   "dartCorpCode": null,
   "businessNumber": null
  },
  "sources": [
   {
    "provider": "opendart",
    "retrievedAt": "2026-10-20T00:00:00.000Z"
   }
  ],
  "ambiguous": false,
  "companies": [
   {
    "name": "삼성전자",
    "match": {
     "type": "stock_code",
     "confidence": 1
    },
    "nameEn": "SAMSUNG ELECTRONICS CO,.LTD",
    "companyId": "kr-dart-00126380",
    "stockCode": "005930",
    "dartCorpCode": "00126380",
    "businessNumber": null
   }
  ],
  "attribution": [
   "Company data from OpenDART (Financial Supervisory Service, Korea), normalized by this service."
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/korea-company-intelligence-resolve-ef36ea9a/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from 1gateway.dev](https://www.zero.xyz/host/1gateway.dev/llms.txt)
