Language & Output Formats

Output Options

English (language: en)

Returns English company names from the DART database. Company names not in DART fall back to the original Korean name.

Request

curl -X POST "https://kynode-api.kynode.workers.dev/v1/verify" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "business_number": "8090903407",
    "startDate": "20240101",
    "ownerName": "강민구",
    "company_name": "노드메트릭스",
    "language": "en"
  }'

Response

{
  "isValid": true,
  "businessInfo": {
    "businessNumber": "8090903407",
    "companyName": "Nodemetrics",
    "companyNameOriginal": "노드메트릭스",
    "companyNameSource": "dart",
    "representative": "강민구",
    "status": "Active",
    "statusCode": "01",
    "taxType": "General VAT Taxpayer",
    "taxTypeCode": "01",
    "verifiedAt": 1747123456789
  }
}

Korean (language: ko)

Returns original Korean data from NTS. Default if language is omitted.

Request

curl -X POST "https://kynode-api.kynode.workers.dev/v1/verify" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "business_number": "8090903407",
    "startDate": "20240101",
    "ownerName": "강민구",
    "company_name": "노드메트릭스",
    "language": "ko"
  }'

Response

{
  "isValid": true,
  "businessInfo": {
    "businessNumber": "8090903407",
    "companyName": "노드메트릭스",
    "representative": "강민구",
    "status": "계속사업자",
    "statusCode": "01",
    "taxType": "일반과세자",
    "taxTypeCode": "01",
    "verifiedAt": 1747123456789
  }
}

Both (language: both)

Returns Korean and English in a single response. Fields like companyName and status become objects with ko/en keys.

Request

curl -X POST "https://kynode-api.kynode.workers.dev/v1/verify" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "business_number": "8090903407",
    "startDate": "20240101",
    "ownerName": "강민구",
    "company_name": "노드메트릭스",
    "language": "both"
  }'

Response

{
  "isValid": true,
  "businessInfo": {
    "businessNumber": "8090903407",
    "companyName": {
      "ko": "노드메트릭스",
      "en": "Nodemetrics",
      "source": "dart"
    },
    "representative": "강민구",
    "status": {
      "ko": "계속사업자",
      "en": "Active",
      "code": "01"
    },
    "taxType": {
      "ko": "일반과세자",
      "en": "General VAT Taxpayer",
      "code": "01"
    },
    "verifiedAt": 1747123456789
  }
}

Code (language: code)

Minimal response with status codes only. Ideal for automated pipelines where you handle status mapping yourself.

Request

curl -X POST "https://kynode-api.kynode.workers.dev/v1/verify" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "business_number": "8090903407",
    "startDate": "20240101",
    "ownerName": "강민구",
    "company_name": "노드메트릭스",
    "language": "code"
  }'

Response

{
  "isValid": true,
  "businessInfo": {
    "businessNumber": "8090903407",
    "companyName": "노드메트릭스",
    "representative": "강민구",
    "statusCode": "01",
    "taxTypeCode": "01",
    "verifiedAt": 1747123456789
  }
}

Status Codes