인증 방식
🔑 API Key
요금
무료
Base URL
api.odcloud.kr/api/nts-businessman/v1
태그
사업자, 국세청
서비스 소개
국세청에서 제공하는 사업자등록 상태 확인 API입니다. 사업자등록번호와 대표자명, 개업일자 등을 입력하면 해당 사업자의 등록 여부, 폐업/휴업 여부를 실시간으로 확인할 수 있습니다. B2B 서비스나 프리랜서 플랫폼에서 사업자 인증 시 활용합니다.
🚀 시작하기
- 1
data.go.kr 가입 및 신청
"국세청_사업자등록정보 진위확인" 검색 → 활용 신청
- 2
서비스 키 발급
마이페이지 → 개발계정 → Decoding 키 복사
- 3
API 호출
POST 방식으로 사업자번호 배열 전송 (최대 100개 일괄 조회)
📋 응답 예시
{
"status_code": "OK",
"data": [{
"b_no": "1234567890",
"b_stt": "계속사업자",
"b_stt_cd": "01",
"tax_type": "부가가치세 일반과세자",
"end_dt": "",
"utcc_yn": "N",
"valid": "01"
}]
}💡 코드 예제
JavaScriptJavaScript
const API_KEY = process.env.NTS_API_KEY
async function verifyBusiness(businessNumbers: string[]) {
const res = await fetch(
`https://api.odcloud.kr/api/nts-businessman/v1/status?serviceKey=${API_KEY}`,
{
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify({ b_no: businessNumbers }),
}
)
const data = await res.json()
return data.data
}
// 사용 예시
const result = await verifyBusiness(['1234567890'])
console.log(result[0].b_stt) // "계속사업자" | "폐업자" | "휴업자"PythonPython
import requests
import os
API_KEY = os.environ["NTS_API_KEY"]
def verify_business(b_nos: list[str]) -> list:
res = requests.post(
f"https://api.odcloud.kr/api/nts-businessman/v1/status",
params={"serviceKey": API_KEY},
json={"b_no": b_nos},
)
return res.json()["data"]
result = verify_business(["1234567890"])
print(result[0]["b_stt"]) # 계속사업자 / 폐업자 / 휴업자