국세청 홈택스에 신고된 이용자의 퇴직소득 지급명세서를 본인 인증만으로 실시간 조회합니다. 근무처별 퇴직급여, 과세대상 퇴직급여, 실제 원천징수된 세액을 확인할 수 있으며, 퇴직금을 수령한 귀속연도에만 자료가 생성되는 만큼 조회 시 반드시 실제 퇴직 연도를 taxYear 로 지정해야 합니다. 조회 절차 1. 본인 인증 - 이용자가 간편인증(quick) 또는 공동·금융인증서(pki)로 본인확인을 수행합니다. 2. 귀속연도 지정 - 실제 퇴직금을 수령한 귀속연도(taxYear)를 지정합니다. 자료가 없는 연도를 지정하면 비과금 실패로 응답합니다. 3. 지급명세서 조회 - 홈택스 시스템에 퇴직소득 지급명세서 조회를 요청합니다. 4. 결과 반환 - 근무처별 퇴직급여, 과세대상 퇴직급여, 원천징수세액을 구조화된 데이터(JSON)로 반환합니다. — Korean retirement income statement (severance pay, withheld tax) from Hometax. Requires user identity auth.
curl -X POST "https://apitree.ai/api/v1/proxy/kr-hometax-retirement-statement" \
-H "Authorization: Bearer nxs_live_YOUR_KEY" \
-H "Content-Type: application/json" \
-H "X-Idempotency-Key: <unique-id>" \
-d '{"auth":"quick","ownerName":"<ownerName>","identity":"<identity>","phoneNo":"<phoneNo>"}'
# 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"