APIFuseAPIFuse
문서서비스플레이그라운드상태
로그인회원가입

Service

Korea Business Verify

한국, 금융실험적
Playground에서 시험API 레퍼런스 열기

Overview

국세청 공공데이터 API(data.go.kr)인 사업자등록정보 진위확인 및 상태조회 서비스의 두 엔드포인트를 통해 한국 사업자의 영업 상태를 조회하고 사업자등록정보의 진위를 확인합니다.

Status

정상

96.00%30일 가동률평균 응답748ms

2026-09-262026-10-112026-10-25

Setup

Auth mode
Managed key
Credentials
  • korea-business-verify scope가 허용된 managed key
Sandbox
미제공

APIs

행을 선택하면 해당 API의 레퍼런스로 이동합니다.

MethodAPIPathSummary
POST/v1/korea-business-verify/check-business-statusLooks up the National Tax Service's operating status (계속사업자/휴업자/폐업자), VAT taxpayer type, and business-unit taxation conversion-closure flag (utcc_yn) for 1 to 100 10-digit business registration numbers (사업자등록번호) in a single call. Use when you only have the registration number and need to verify that a counterparty's business is still active before invoicing or onboarding. Do NOT use for the separate authenticity check (진위확인: matching the number against the opening date and representative name) — use korea-business-verify:validate-business-registration instead. Returns results (one row per submitted number with b_stt/b_stt_cd, tax_type/tax_type_cd, end_dt, utcc_yn, tax_type_change_dt, invoice_apply_dt, and rbf_tax_type/rbf_tax_type_cd) plus request_count and match_count.
POST/v1/korea-business-verify/validate-business-registrationValidates up to 10 Korean business identities per call against the National Tax Service (NTS) authenticity-check (진위확인) endpoint. Use when you have the 10-digit business registration number, opening date (YYYYMMDD), and representative name and need to confirm they match NTS records. Do NOT use for a status-only lookup when you only have the registration number — use korea-business-verify:check-business-status instead. Optional Korean representative name, business name, corporate registration number, business sector/type, and address are forwarded as supplied. Returns results (one per submitted record with b_no, valid, valid_code, valid_message, and the current tax status when NTS supplies it) plus request_count and valid_count; the submitted identity details are not echoed back.

Related guides

  • sandbox key를 발급받고 첫 예약 생성까지 진행합니다.

  • 파트너 credential은 APIFuse이 보관합니다. 발급받는 것은 하나의 managed key입니다.

  • 예약 확정, 배달 상태 변경 같은 이벤트를 webhook으로 수신합니다.

  • 서비스 장애와 게이트웨이 에러를 하나의 에러 모델로 정규화합니다.

사업자 상태 조회
사업자등록정보 진위확인
빠른 시작
Managed key
개요
에러 모델