세법 실무를 위한 국가기관 개방 API 활용 안내

1. 핵심 요약

세법 관련 국가 데이터는 법제처(법령·판례·해석례), 공공데이터포털(사업자등록 상태·진위확인), 열린국회정보(세법 개정 법률안) 세 곳에서 무료로 개방하고 있습니다.

세 플랫폼은 인증 파라미터명이 각각 OC, serviceKey, KEY로 서로 다르며, 호출 허용량과 승인 절차도 동일하지 않으므로 개별 명세를 반드시 확인해야 합니다.

특히 국세청 예규(법령해석)는 목록 조회 API만 개방되어 있고 본문 조회 API가 없으므로, 예규 본문까지 자동 수집하려는 설계는 성립하지 않습니다.

법제처 법령정보를 외부에 제공할 때 출처를 표기하지 않으면 저작권법상 형사처벌 대상이 될 수 있으므로 화면·출력물에 출처 표기가 필요합니다.

2. API란 무엇인가 — 민원 창구에 비유하면

API는 기관이 마련해 둔 ’자동화 민원 창구’입니다

세무서에 서류를 떼러 갔다고 가정해 보겠습니다. 민원인이 서고에 직접 들어가 서류를 뒤지지는 않습니다. 창구에 정해진 서식으로 신청서를 제출하면, 담당자가 정해진 형식의 서류를 내어줍니다. API(Application Programming Interface)는 이 창구를 사람이 아니라 프로그램이 이용할 수 있게 만들어 둔 것입니다. 기관이 “이런 양식으로 요청하면, 이런 형식으로 답을 주겠다”고 미리 약속해 둔 규칙이라고 보시면 됩니다.

요청과 응답의 대응 관계를 정리하면 다음과 같습니다.

창구 이용을 위한 신분 확인 → 인증키 (OC, serviceKey, KEY)
신청서에 적는 기재 사항 → 요청 파라미터 (세목, 검색어, 기간)
창구에서 받아 오는 서류 → 응답 데이터 (XML, JSON)
하루 발급 가능 건수 제한 → 호출 허용건수

사람이 화면을 보고 하던 일을 프로그램이 대신합니다

예를 들어 거래처 500곳의 폐업 여부를 확인해야 한다고 가정해 보겠습니다. 담당 직원이 홈택스 화면에서 사업자등록번호를 하나씩 입력해 500번을 조회하면 반나절이 걸립니다.

API를 이용하면 500개 번호를 한 번에 목록으로 전달하고, 각각의 운영상태(계속·휴업·폐업)를 한꺼번에 돌려받을 수 있습니다. 같은 일을 사람이 아닌 프로그램이 처리하되, 조회하는 자료 자체는 홈택스에서 보는 것과 동일한 국세청 원본이라는 점이 핵심입니다.

도서관 색인과 대출에 비유하면 2단계 조회가 이해됩니다

법제처 API는 자료를 한 번에 주지 않고 두 단계로 나누어 제공합니다. 도서관에서 먼저 색인 목록을 훑어 필요한 책의 청구기호를 확인하고, 그 청구기호로 실제 책을 받아 오는 것과 같은 구조입니다.

1단계 목록 조회: 검색 조건에 맞는 조문·판례의 일련번호를 수집
2단계 본문 조회: 그 일련번호로 실제 조문·판례 본문을 수신

※ 그래서 본문 조회 API가 열려 있지 않은 자료(국세청 법령해석 등)는 “색인은 볼 수 있지만 책은 대출되지 않는” 상태와 같습니다. 목록에서 어떤 예규가 있는지는 확인되지만, 본문은 프로그램으로 받아올 수 없습니다.

유료 정보 서비스와 무엇이 다른가

국가기관이 개방한 API는 원칙적으로 무료이며, 가공을 거치지 않은 원본 자료를 그대로 제공합니다. 다만 검색 편의 기능이나 해설은 포함되지 않으므로, 실무에 쓰려면 수집한 자료를 정리·검증하는 과정이 별도로 필요합니다.

즉 API는 완성된 서비스가 아니라, 서비스를 만들기 위한 원재료를 받아 오는 통로입니다.

3. 기관별 제공 데이터와 확인된 범위

법제처 — 국가법령정보 공동활용 (open.law.go.kr)

세법 본문, 판례, 법령해석례, 행정규칙, 별표·서식 등을 개방합니다. 세무 실무와 직접 관련된 항목은 다음과 같습니다.

현행법령(시행일 기준) 목록 및 본문 조회
현행법령(공포일 기준) 목록 및 본문 조회
법령 연혁 목록 및 본문 조회
조항호목 단위 본문 조회
판례 목록 및 본문 조회 (데이터출처에 국세법령정보시스템이 포함되어 조세 판례 수집 가능)
조세심판원 특별행정심판례 목록 및 본문 조회
법령 변경이력, 일자별 조문 개정 이력, 조문별 변경 이력 조회

※ 중앙부처 1차 해석 중 국세청과 재정경제부는 목록 조회 API만 제공되며 본문 조회 API는 개방되어 있지 않습니다. 예규 본문은 국세법령정보시스템에서 별도로 확인해야 합니다.

※ 조세심판원 재결례는 일반 ’행정심판례’가 아니라 ‘특별행정심판’ 분류에 속하며, 목록과 본문이 모두 제공됩니다.

국세청 — 공공데이터포털 (data.go.kr)

사업자등록정보 진위확인 및 상태조회 서비스를 개방하고 있습니다.

상태조회: 사업자등록번호만으로 운영상태(계속·휴업·폐업), 과세유형, 폐업일자 조회
진위확인: 사업자등록번호, 개업일자, 대표자명을 함께 제출하여 국세청 보유 정보와의 일치 여부 확인

※ 국세통계포털(TASIS)은 별도의 오픈API를 제공하지 않으며, 공공데이터포털에 개방된 국세청 통계는 대부분 파일데이터 형태입니다.

행정안전부·지방자치단체 — 지방세 관련

개별 납세자의 지방세 과세표준을 조회하는 개방 API는 없습니다. 공공데이터포털에 개방된 지방세 데이터는 지자체별 지방세 과세현황, 비과세·감면 현황, 미환급금 현황 등 통계성 자료이며, 파일데이터가 오픈API(JSON/XML) 형태로 자동 변환되어 함께 제공됩니다.

국회 — 열린국회정보 (open.assembly.go.kr)

세법 제·개정 법률안, 의안 심의 경과, 의안정보 통합 정보를 RESTful 방식으로 제공하며, 세법 개정 동향을 사전에 추적하는 데 활용합니다.

4. 인증 및 요청 구조

인증 파라미터는 플랫폼마다 다릅니다

법제처: OC (신청 후 발급되는 API인증값)
공공데이터포털: serviceKey (인코딩키·디코딩키 2종 발급)
열린국회정보: KEY (인증키 다중 발급 가능)

※ 하나의 ’ServiceKey’로 세 플랫폼을 공통 처리할 수 없습니다.

※ 열린국회정보는 인증키를 넣지 않으면 sample로 처리되어 10건만 반환되므로, 전량 수집 시 반드시 인증키를 포함해야 합니다.

승인 절차도 동일하지 않습니다

법제처: 회원가입 후 활용신청 → 담당자 심의 (승인까지 통상 1~2일 소요)
공공데이터포털: 국세청 사업자등록 서비스는 개발단계·운영단계 모두 자동승인

법제처는 목록 조회와 본문 조회가 분리되어 있습니다

1단계 목록 조회로 일련번호를 수집한 뒤, 2단계 본문 조회로 내용을 받는 구조입니다.

목록 조회: www.law.go.kr/DRF/lawSearch.do
본문 조회: www.law.go.kr/DRF/lawService.do

target 값으로 대상을 지정하며(법령 law, 판례 prec, 법령해석례 expc, 행정규칙 admrul 등), type 값으로 출력 형식(HTML/XML/JSON)을 선택합니다. 목록 조회의 한 페이지 결과 수는 기본 20건, 최대 100건입니다.

국세청 사업자등록 API는 POST 방식입니다

조회 대상 사업자등록번호를 요청 본문(JSON)에 배열로 담아 전송합니다.

상태조회: api.odcloud.kr/api/nts-businessman/v1/status
진위확인: api.odcloud.kr/api/nts-businessman/v1/validate

인증키는 쿼리스트링의 serviceKey로 전달하거나, 요청 헤더의 Authorization에 넣어 전달합니다.

※ 진위확인은 사업자등록번호, 개업일자, 대표자명이 모두 필수입니다.

5. 실무 개발 시 유의사항

호출 제한은 API마다 확인해야 합니다

플랫폼 단위로 일괄된 제한이 적용된다고 전제하면 설계가 어긋납니다.

국세청 사업자등록 서비스: 1회 100건, 1일 100만건 (개발계정 신청 가능 트래픽 1,000,000)
공공데이터포털 일반 API: 개발계정 기준 1,000~10,000건 수준이 많으며, 운영계정은 활용사례 등록 후 증설 신청 가능
법제처: 일일 허용 건수를 별도로 공개하지 않으며, 트래픽 초과로 시스템 부하가 발생하면 활용이 제한될 수 있다고 안내

캐싱이 필요한 이유는 호출 제한만이 아닙니다

사업자등록 정보는 국세청 원본과 30분 주기로 동기화되며, 신규 개업자는 반영까지 1~2일이 소요됩니다. 따라서 조회 결과를 확정적 사실로 쓰지 말고 조회 시점을 함께 보관해야 합니다.

법령·판례 본문은 변경 빈도가 낮으므로 로컬 DB에 적재한 뒤 변경분만 주기적으로 동기화하는 방식이 효율적입니다.

본문 텍스트 전처리

판례·해석례 본문에는 HTML 태그와 특수문자가 함께 전달될 수 있으므로, 태그 제거와 메타데이터 분리 과정을 거쳐야 검색·비교에 쓸 수 있습니다.

개정 이력 관리

세법은 매년 개정되므로 조문을 식별할 때 법령ID와 시행일자를 함께 키로 사용해야 과거 시점 세법과 현행 세법이 섞이지 않습니다.

법제처는 현행법령(시행일 기준)과 현행법령(공포일 기준)을 별도 API로 제공하므로, 어느 기준으로 수집할지 먼저 정한 뒤 설계해야 합니다. 과거 시점 조문이 필요하면 법령 연혁 API와 조문별 변경 이력 API를 함께 사용합니다.

오류 응답 처리

공공데이터포털은 일일 호출 초과(에러코드 22), 초당 호출 초과(23), 미등록 인증키(30), 인증키 기한 만료(31) 등을 코드로 구분해 반환하므로, 재시도 대상 오류와 즉시 중단할 오류를 나누어 처리해야 합니다.

6. 법적 유의사항

출처 표기 의무

※ 홈페이지나 내부 시스템에 법령 본문을 노출할 경우, 화면과 출력물 모두에 출처를 명시하십시오.

상업적 활용 제한

법제처는 상업적 이용이 불가능한 API를 상업적으로 활용한 경우 활용을 제한할 수 있다고 안내하고 있으므로, 유상 서비스에 연동하기 전에 해당 API의 이용 조건을 개별 확인해야 합니다.

7. 자가 점검 방법

제공 범위와 호출 제한은 개정·변경될 수 있으므로 각 포털에서 직접 확인하시기 바랍니다.

법제처 제공 범위 확인 — open.law.go.kr 접속 → [OPEN API] → [OPEN API 활용가이드] → 대상 항목의 목록 조회·본문 조회 제공 여부 확인
공공데이터포털 호출 제한 확인 — data.go.kr 접속 → 해당 오픈API 상세화면 → [이용 조건 및 라이선스 정보] → 신청 가능 트래픽·심의유형 확인
열린국회정보 명세 확인 — open.assembly.go.kr 접속 → [Open API] → [Open API 목록] → 대상 API 명세표 내려받기

8. 관련 법령

공공데이터의 제공 및 이용 활성화에 관한 법률 (공공데이터 개방·이용의 근거 법률)

작성 기준

작성 기준일: 2026년 9월

법제처 국가법령정보 공동활용 OPEN API 제공 목록(총 191건) 기준으로 기관별 제공 범위를 재확인하여 반영
국세청 사업자등록정보 진위확인 및 상태조회 서비스의 호출 허용건수(1회 100건 / 1일 100만건) 및 갱신 주기를 최신 명세 기준으로 반영

본 안내문은 2026년 9월 현재 각 기관이 공개한 API 명세 및 이용안내를 기준으로 작성된 일반적인 정보 제공 자료입니다. 제공 범위와 호출 조건은 기관 사정에 따라 변경될 수 있으므로, 실제 적용 시에는 해당 기관의 최신 명세를 직접 확인해야 합니다.