API Reference

Complete reference for the Kynode API.

Base URL

https://api.kynode.dev/v1

Authentication

Kynode uses API keys to authenticate requests. Include your API key in the Authorization header.

Authorization: Bearer YOUR_API_KEY

💡 Tip: Keep your API keys secure. Don't commit them to version control.

Verify Business

POST /verify/business

Verify a Korean business registration number and retrieve company information.

Request Body

Parameter	Type	Required	Description
business_number	string	Yes	Korean business registration number (format: 123-45-67890 or 1234567890)
language	string	No	Response language: en, ko, ja, zh-CN, es, de (default: en)

Example Request

curl -X POST https://api.kynode.dev/v1/verify/business \
  -H "Authorization: Bearer sk_live_abc123..." \
  -H "Content-Type: application/json" \
  -d '{
    "business_number": "123-45-67890",
    "language": "en"
  }'

Response

Success Response200 OK

{
  "valid": true,
  "company_name": "Samsung Electronics",
  "company_name_en": "Samsung Electronics Co., Ltd.",
  "status": "active",
  "business_number": "123-45-67890",
  "representative_name": "Jong-Hee Han",
  "industry": "Electronics Manufacturing",
  "industry_code": "26400",
  "registered_date": "1969-01-13",
  "address": "129 Samsung-ro, Yeongtong-gu, Suwon-si, Gyeonggi-do",
  "address_en": "129 Samsung-ro, Suwon-si, Gyeonggi-do, South Korea",
  "metadata": {
    "tax_type": "Corporation",
    "employee_count": 267937,
    "capital": 897514000000,
    "revenue": 302231000000000
  }
}

Response Fields

Field	Type	Description
valid	boolean	Whether the business number is valid
company_name	string	Company name (localized)
status	string	Business status: active, inactive, suspended
industry	string	Industry category (localized)
registered_date	string	Registration date (ISO 8601)

Errors

Kynode uses conventional HTTP response codes to indicate success or failure.

Code	Description
200	Success
400	Bad Request - Invalid parameters
401	Unauthorized - Invalid API key
404	Not Found - Business not found
429	Too Many Requests - Rate limit exceeded
500	Internal Server Error

Error Response Format

{
  "error": {
    "code": "invalid_business_number",
    "message": "The business number format is invalid",
    "details": {
      "parameter": "business_number",
      "value": "invalid"
    }
  }
}

Rate Limits

Kynode enforces rate limits to ensure service quality for all users.

Free Tier1,000 requests/month

Paid Tier100 requests/second

Need higher limits? Contact us for enterprise pricing.