# Korea Company Intelligence

> Korea Company Intelligence 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).

Checks the operating status of South Korean businesses by registration number against National Tax Service data, returning active/suspended/closed/unregistered status and VAT details.

## Facts

- Endpoint: GET https://1gateway.dev/v1/kr/business/status?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-cd5cd345
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_n6jqv7rBaJ1dSWAoDKtKE

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-cd5cd345
```

Example prompt: Can you check whether the South Korean company with business registration number 124-81-00998 is still active and hasn't been closed or suspended?

## When to prefer this

Use this endpoint when you need real-time (sub-30-minute) operating status for South Korean businesses specifically, particularly for KYB, accounts payable, invoice validation, or vendor onboarding workflows. It is the right choice over general business registries when you need NTS-authoritative data including VAT type and e-invoice eligibility, and when you need to check up to 20 numbers in a single call at low per-call cost.

## Known failure modes

- Invalid check digit on a registration number returns HTTP 400 and no charge
- Unregistered number returns status 'unregistered' in the response body
- Rate limiting or quota exceeded returns appropriate HTTP error
- Malformed b_no pattern (wrong format) returns 400 validation error
- Stale data possible up to 30 minutes behind NTS source

## How this service works

1gateway lets AI agents buy the data and APIs they need, one call at a time: no signup, no API key, paid per request with USDC on Base or Solana via x402. Coverage: company and compliance checks (sanctions, KYB, SEC filings, Korean companies), Korean real estate, trade and macro data, onchain and market data, and agent utilities such as document-to-Markdown. Every response names its source. Failed calls are never charged.

## Output

A JSON object containing a count, timestamp (asOf), cache metadata, and an array of business records — one per registration number — each with: status (active/suspended/closed/unregistered), statusKo (Korean label), registered boolean, VAT taxType and taxTypeKo, closedDate, previousTaxType, taxTypeChangedDate, invoiceApplyDate, closedByUnitTaxationSwitch, companyId, and a human-readable message. Data is sourced from Korea NTS and refreshed every 30 minutes.

## 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": [
      "b_no"
     ],
     "properties": {
      "b_no": {
       "type": "string",
       "pattern": "^\\d{3}-?\\d{2}-?\\d{5}(,\\s*\\d{3}-?\\d{2}-?\\d{5}){0,19}$",
       "examples": [
        "1248100998"
       ],
       "maxLength": 260,
       "description": "Business registration numbers (사업자등록번호), 10 digits each, comma-separated (max 20); invalid check digit → 400, not charged"
      }
     },
     "additionalProperties": false
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "required": [
      "count",
      "asOf",
      "notes",
      "attribution",
      "cache",
      "businesses"
     ],
     "properties": {
      "asOf": {
       "type": "string"
      },
      "cache": {
       "type": "string"
      },
      "count": {
       "type": "integer"
      },
      "notes": {
       "type": "array",
       "items": {
        "type": "string"
       }
      },
      "businesses": {
       "type": "array",
       "items": {
        "type": "object",
        "properties": {
         "status": {
          "type": "string"
         },
         "message": {
          "type": [
           "string",
           "null"
          ]
         },
         "taxType": {
          "type": [
           "string",
           "null"
          ]
         },
         "statusKo": {
          "type": [
           "string",
           "null"
          ]
         },
         "companyId": {
          "type": "string"
         },
         "taxTypeKo": {
          "type": [
           "string",
           "null"
          ]
         },
         "closedDate": {
          "type": [
           "string",
           "null"
          ]
         },
         "registered": {
          "type": "boolean"
         },
         "businessNumber": {
          "type": "string"
         },
         "previousTaxType": {
          "type": [
           "string",
           "null"
          ]
    
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "asOf": "2026-10-19T00:00:00.000Z",
  "cache": "miss",
  "count": 3,
  "notes": [
   "NTS syncs its register every 30 minutes; newly registered businesses can take 1-2 days to appear."
  ],
  "businesses": [
   {
    "status": "active",
    "message": null,
    "taxType": "vat_general",
    "statusKo": "계속사업자",
    "companyId": "kr-brn-1248100998",
    "taxTypeKo": "부가가치세 일반과세자",
    "closedDate": null,
    "registered": true,
    "businessNumber": "1248100998",
    "previousTaxType": null,
    "invoiceApplyDate": null,
    "taxTypeChangedDate": null,
    "closedByUnitTaxationSwitch": false
   }
  ],
  "attribution": "Business registration status from the National Tax Service (국세청) via data.go.kr (dataset 15081808, no usage restriction). Translated by this service."
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/korea-company-intelligence-cd5cd345/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)