Korea Ground-Truth / Tools / verify_business_registration
사업자등록번호 조회 API — 계속사업자/휴업/폐업 상태 확인, 진위확인
Korean Business Registration Number Verification API (status + validation)
Cost: 2 credits/call (cache hit: 1). ≈ 20원/호출 · 출처: 국세청 (data.go.kr) · 캐시 1시간
어떤 문제를 푸나
거래처·입점 셀러·계약 상대방의 사업자등록번호가 실제 등록되어 있고 영업 중인지, 대표자명·개업일이 일치하는지를 에이전트가 직접 확인할 방법이 없습니다. 국세청 원본 데이터를 정규화된 JSON으로 반환합니다.
- 입점/가입 심사 자동화 (KYB)
- 세금계산서 발행 전 거래처 상태 확인
- 계약서 작성 전 상대방 사업자 검증
- CRM 데이터 정리 (폐업 거래처 필터링)
호출 방법
REST
curl -X POST https://kr-groundtruth-mcp.vercel.app/v1/tools/verify_business_registration \
-H "Authorization: Bearer kgt_live_..." \
-H "content-type: application/json" \
-d '{"business_numbers":["124-81-00998","123-45-67890"]}'MCP (Claude Code / Cursor / any MCP client)
claude mcp add --transport http kgt https://kr-groundtruth-mcp.vercel.app/api/mcp --header "Authorization: Bearer kgt_live_..."
# then ask: "verify_business_registration 툴로 {"business_numbers":["124-81-00998","123-45-67890"]} 조회해줘"API 키 발급 (사람 불필요, 무료 50 credits)
curl -X POST https://kr-groundtruth-mcp.vercel.app/v1/accounts -H "content-type: application/json" -d '{"email":"you@example.com"}'입력
| field | type | required | description |
|---|---|---|---|
business_numbers | array | yes | 사업자등록번호 목록 (하이픈 유무 무관) |
representative_name | string | no | 진위확인용 대표자명 (단건 조회 시) |
opened_date | string | no | 진위확인용 개업일자 YYYYMMDD (단건 조회 시) |
business_name | string | no | 진위확인용 상호 (선택) |
응답 예시 (실제 응답, 2026-08-26)
{
"ok": true,
"data": {
"source": "국세청 사업자등록정보 (data.go.kr)",
"results": [
{
"business_number": "1248100998",
"registered": true,
"status": "active",
"status_raw": "계속사업자",
"tax_type": "부가가치세 일반과세자",
"tax_type_code": "01",
"closed_date": null,
"unit_taxpayer": false,
"tax_type_changed_date": null,
"e_invoice_apply_date": null
},
{
"business_number": "1234567890",
"registered": false,
"status": "not_registered",
"status_raw": "국세청에 등록되지 않은 사업자등록번호입니다.",
"tax_type": "국세청에 등록되지 않은 사업자등록번호입니다.",
"tax_type_code": "",
"closed_date": null,
"unit_taxpayer": false,
"tax_type_changed_date": null,
"e_invoice_apply_date": null
}
]
},
"meta": {
"tool": "verify_business_registration",
"cost": 2,
"balance_remaining": 48,
"cache_hit": false,
"source": "국세청 (data.go.kr)",
"fetched_at": "2026-08-26T14:00:00.000Z",
"usage_event_id": "usg_…"
}
}모든 응답은 meta.cost, meta.balance_remaining를 포함합니다. 업스트림 오류 시 자동 환불되며, 잔액 부족 시 402 INSUFFICIENT_CREDITS와 함께 충전 URL이 반환됩니다.
함께 쓰는 툴
- 기업정보 조회 API — 대표자·법인등록번호·사업자번호·주소·설립일 (DART 기업개황) — Cost: 2 credits/call (cache hit: 1).
- 주소 정규화 API — 도로명주소·우편번호·법정동코드 변환 — Cost: 1 credit/call (cache hit: 1).