국세청

국세청 사업자등록정보 진위확인 및 상태조회 서비스

국세청 사업자등록정보 진위확인(validate)+상태조회(status). 인증키 없이 GET /api/bizinfo로 바로 호출(action=status 상태조회, action=validate 진위확인). 서버에 odcloud 인증키 등록 완료 — 바로 호출 가능. 계속사업자/휴업/폐업 여부, 과세유형(일반/간이/면세), 진위 일치여부(valid 01 일치/02 불일치)를 제공한다.

⚡ 사업자등록 진위확인·상태조회 간편 호출

GET /api/bizinfo?action=status&b_no=1234567890

사업자 상태·진위 확인이 필요하면 이 주소를 먼저 사용. 인증키 불필요, action=status|validate. 서버 키 등록 완료 — 바로 호출 가능.

에이전트가 얻을 수 있는 정보

b_stt(계속사업자/휴업자/폐업자), b_stt_cd, tax_type(과세유형 텍스트), tax_type_cd, end_dt(폐업일), utcc_yn(단위과세전환), tax_type_change_dt, invoice_apply_dt / valid(01 일치/02 불일치), valid_msg
거래처 사업자등록 상태 확인, 휴·폐업 여부 검증, 세금계산서 발행 가능 여부 판단, 명의·개업일 일치 진위확인

활용 사례

사업자번호로 계속사업자·휴업·폐업 상태 조회
과세유형(일반/간이/면세) 확인
사업자번호+개업일+대표자명 진위 일치 확인

등록 API (2)

사업자 상태조회 status

사업자번호로 등록 상태 조회. 1회 최대 10개(원본 100개, 간편 API 제한). 미등록 번호는 tax_type에 '국세청에 등록되지 않은 사업자등록번호입니다.'로 응답

b_no 필수 — 사업자등록번호 10자리 (하이픈 제거, 공백·쉼표로 여러 개) 예: 1234567890

출력: match_cnt(매칭 수), items[](b_no/b_stt/b_stt_cd/tax_type/tax_type_cd/end_dt/utcc_yn/tax_type_change_dt/invoice_apply_dt)

호출 한도: 일 1,000회 (odcloud 기본 제공량, 상세 한도는 odcloud 활용현황 참조)

사업자등록정보 진위확인 validate

사업자번호+개업일자+대표자명 일치 확인. 1회 1건. 일치하면 valid 01, 불일치하면 02

b_no 필수 — 사업자등록번호 10자리 예: 1234567890
start_dt 필수 — 개업일자 YYYYMMDD 예: 20200101
p_nm 필수 — 대표자 성명 (1~30자) 예: 홍길동

출력: valid(01 일치/02 불일치), valid_msg(일치 시 과세유형 문구)

호출 한도: 일 1,000회 (odcloud 기본 제공량, 상세 한도는 odcloud 활용현황 참조)

인증·비용·약관

인증 방식	ServiceKey — odcloud 인증키(serviceKey 쿼리). 프록시 서버에만 보관하며 에이전트에게 노출하지 않는다. 에이전트는 우리 간편 API(/api/bizinfo)만 호출한다.
비용	무료. 개발계정 자동승인
이용허락	공공데이터 (data.go.kr 활용신청 조건 준수, 출처표시)
재배포	허용 (출처표시 필수)
약관 확인일	2026-10-13
활용신청	data.go.kr 로그인 → 국세청_사업자등록정보 진위확인 및 상태조회 서비스 활용신청 → 인증키 발급 (개발계정 자동승인) 포털 바로가기
운영 상태	운영 중
최종 확인일	2026-10-13

에이전트 호출 방법

우리 프록시를 통해 호출합니다. 헤더 X-Agent-Token이 필요합니다. 토큰 발급은 /agencatalog/register/에서 신청 후 승인받습니다. 전체 서비스 목록은 /agencatalog/api/services.json을 참조하세요.

기계용 JSON 스키마

{
  "service": "nts-bizinfo-validate",
  "name": "국세청 사업자등록정보 진위확인 및 상태조회 서비스",
  "provider": "국세청",
  "apis": [
    {
      "id": "status",
      "name": "사업자 상태조회",
      "params": [
        {
          "name": "b_no",
          "required": true,
          "example": "1234567890",
          "desc": "사업자등록번호 10자리 (하이픈 제거, 공백·쉼표로 여러 개)"
        }
      ]
    },
    {
      "id": "validate",
      "name": "사업자등록정보 진위확인",
      "params": [
        {
          "name": "b_no",
          "required": true,
          "example": "1234567890",
          "desc": "사업자등록번호 10자리"
        },
        {
          "name": "start_dt",
          "required": true,
          "example": "20200101",
          "desc": "개업일자 YYYYMMDD"
        },
        {
          "name": "p_nm",
          "required": true,
          "example": "홍길동",
          "desc": "대표자 성명 (1~30자)"
        }
      ]
    }
  ],
  "proxy_call": "POST /agencatalog/api/call",
  "attribution": "출처: 국세청 사업자등록정보 진위확인 및 상태조회 서비스(공공데이터포털 data.go.kr, odcloud 중계)"
}

이용 시 주의사항

기관 API 키는 서버에만 보관됩니다. 직접 키를 요청하는 클라이언트는 이 경로를 사용할 수 없습니다.
기관별 일일 한도가 있습니다. 한도 초과 시 429를 반환하고 추가 호출을 차단합니다.
기관 API 장애·한도 초과 시 오류가 전달됩니다. 재시도 전에 응답의 error 필드를 확인하세요.
출처 표기: 출처: 국세청 사업자등록정보 진위확인 및 상태조회 서비스(공공데이터포털 data.go.kr, odcloud 중계)

마지막 확인: 2026-10-13

AI 크롤러 · 수집 기록