개인9 APIs

홈택스 소득정보

#소득증명#연말정산#홈택스#국세청#진위확인#청년우대#신용평가#증빙자동화

OVERVIEW

상품요약

국세청 홈택스에서 개인이 발급·확인할 수 있는 소득 관련 증명 자료 — 소득금액증명(통합), 면세사업자 수입금액증명, 연말정산 간소화 소득·세액공제 자료, 청년우대형 주택청약·청년희망적금·청년형 장기집합투자증권저축 등 특례 상품용 소득확인증명, 일용근로·간이지급명세서·과세자료 제출명세서 기반 본인 소득 내역, 민원증명 원본 진위 확인 — 을 한 번에 조회하는 유형의 API입니다. 개인이 근로·사업·연금·기타 소득 형태별로 흩어져 있는 과세 자료를 하나의 호출로 수집할 수 있어, 핀테크·신용평가·정책지원 서비스가 고객에게 종이 서류를 요구하지 않고 본인 동의 기반 전자 증빙으로 대체하는 플로우를 구성할 때 자주 선택되는 카테고리입니다. 발급된 민원증명의 '원본 진위 확인' 엔드포인트도 포함되어 제출된 증명서의 위·변조 여부를 교차 검증하는 용도로도 쓰입니다.

SYSTEM FLOW

시스템 흐름

클라이언트 요청이 SIONLAB API 게이트웨이를 거쳐 원천 기관으로 전달·통합되는 경로입니다. 9개 서브 API를 병렬로 호출해 단일 응답으로 정규화합니다.

ENDPOINTS

제공 API (9종)

API명제공 정보자료 출처
면세사업자 수입금액증명원
반환발급자 정보·사업자 정보·과세기간·수입금액
홈택스
연말정산 간소화 소득·세액공제 자료 조회 (개인 전용)
반환합계금액·귀속년도·보험료·의료비·교육비·개인연금저축/연금계좌·신용카드·현금영수증·직불카드·국민연금 등 공제 항목별 사용 내역
홈택스
소득금액증명(통합)
반환근로소득자·연말정산 사업자·종합소득세 신고자·연말정산 연금소득자·연말정산 종교인 소득을 통합한 소득금액증명
홈택스
소득확인증명(개인종합자산관리계좌)
반환발급자 정보·소득구분·귀속연도·소득금액·결정세액
홈택스
소득확인증명(청년우대형 주택청약종합저축)
반환발급자 정보·소득구분·귀속연도·소득금액·결정세액
홈택스
민원증명 원본확인
입력문서확인번호
반환사업자등록증명·소득금액증명·부가가치세 과세표준증명·면세사업자 수입금액증명·납부내역증명·납세증명서·휴폐업사실증명·소득확인증명·소득세액공제확인서·근로자녀장려금 수급사실증명·표준재무제표증명·모범납세자증명·거주자증명서·임대차 정보제공요청서·해외이주비·부동산매각자금·예금 자금출처 확인서 등의 진위 여부
홈택스
소득확인증명(청년희망적금)
반환소득자 성명·생년월일·주소·귀속연도·소득구분·원천징수의무자·총급여·종합(결정) 소득금액·근로소득 유무·사업소득 유무·개인종합자산관리계좌 소득요건 충족 여부
홈택스
소득확인증명(청년형 장기집합투자증권저축)
반환소득자 성명·생년월일·주소·귀속연도·소득구분·원천징수의무자·총급여·종합(결정) 소득금액·근로소득 유무·사업소득 유무·소득요건 충족 여부
홈택스
본인 소득내역 확인
반환일용근로소득 지급명세서·간이지급명세서(근로/사업)·과세자료 제출명세서별로 접수일자·처리상태·귀속연도·지급월·사업자(주민)등록번호·상호·지급액·제출일자
홈택스

USE CASES

이용사례

핀테크·신용평가·캐피탈·공공기관이 종이 서류 제출을 전자 증빙으로 대체하고, 청년·정책 상품 가입 자격 확인을 자동화하기 위해 자주 선택되는 개인 소득·증명 자료 조회 API 유형입니다.

핀테크·금융 서비스의 소득 증빙 자동화

  • 회원가입·대출 신청 시 재직·소득 서류를 고객 직접 업로드 대신 본인 동의 기반 전자 조회로 대체
  • 연말정산 간소화 자료를 활용해 신용점수 산정 근거 데이터의 풍부도를 높이는 구조에 활용
  • 민원증명 원본 확인으로 제출된 증명서의 위·변조 여부를 실시간 교차 검증

신용평가·대안 신용 모델

  • 비금융정보 기반 신용평가에 본인 소득내역·종합소득금액을 피처로 편입
  • 개인사업자 대상 매출·소득 자료를 자동 수집해 평가 자료 간소화에 활용
  • 청년 대상 특례 상품(청년우대 주택청약 등) 자격 판정의 표준 증빙 수단으로 채택

공공기관·정책 지원 대상자 검증

  • 정책지원금·장학금·주거지원 자격 심사의 소득 증빙을 온라인 본인 동의로 대체
  • 수혜 대상자 재심사 주기마다 소득 변동을 자동으로 재확인하는 구조에 활용
  • 지자체 청년·신혼부부 대상 특례 지원 신청 플로우의 증빙 자동화에도 쓰임

RECOMMENDED

추천 API