Skip to main content

연말정산 간소화 자료

LiveMCP ReadyHealth A (100)세무

보험료, 의료비, 교육비, 신용카드 사용액, 기부금 등 연말정산에 필요한 15개 항목의 소득·세액공제 자료를 홈택스에서 항목별로 한 번에 조회합니다. 조회 절차 1. 본인 인증 - 이용자가 간편인증(quick) 또는 공동·금융인증서(pki)로 본인확인을 수행합니다. 2. 조회 요청 - 귀속연도(taxYear)와 조회할 공제 항목(categories)을 지정해 연말정산 간소화자료 일괄 조회를 요청합니다. 3. 항목별 데이터 수신 - 보험료·의료비·교육비·기부금 등 15개 항목별 기본내역과 월별 상세 데이터를 수신합니다. 4. 결과 반환 - 구조화된 데이터(JSON) 형태로 일괄 반환합니다. — Korean year-end tax settlement simplified data (insurance, medical, education, card spend, donations) from Hometax. Requires user identity auth.

0 회 호출SLA 99.50%60 크레딧/호출캐시 300s
실호출 검증
실호출 미검증

최근 7일 안에 성공한 실호출 기록이 없습니다.

Quick Start

Agent-First
curl -X POST "https://apitree.ai/api/v1/proxy/kr-hometax-yearend-tax" \
  -H "Authorization: Bearer nxs_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -H "X-Idempotency-Key: <unique-id>" \
  -d '{"auth":"quick","ownerName":"<ownerName>","phoneNo":"<phoneNo>","identity":"<identity>"}'

# repeat every 3 s until status is "done" or "failed" (stop on 410/504; a job unfinished after 8 minutes expires)
curl "https://apitree.ai/api/v1/jobs/<job_id>" \
  -H "Authorization: Bearer nxs_live_YOUR_KEY"
본인인증 호출 방식: 제출, 폴링, 과금 안내