근로자 개인이 지급받은 근로소득에 대해 홈택스에 신고된 원천징수영수증(지급명세서와 같은 서식)을 본인 인증만으로 실시간 조회합니다. 회사별로 총급여, 근로소득공제, 소득세·지방소득세 결정세액을 확인할 수 있어, 연말정산 이후 확정된 소득·세액 정보를 검증하는 자료로 활용할 수 있습니다. 조회 절차 1. 본인 인증 - 이용자가 간편인증(quick) 또는 공동·금융인증서(pki)로 홈택스 본인확인 절차를 수행합니다. 2. 조회 요청 - 인증 완료 후 조회할 귀속연도(taxYear)를 지정해 원천징수영수증 데이터를 요청합니다. 3. 데이터 수신 - 회사별 총급여, 근로소득공제, 소득세·지방소득세 결정세액을 수신합니다. 4. 결과 반환 - 구조화된 데이터(JSON) 형태로 반환합니다. — Korean withholding tax receipt for wage income by employer from Hometax. Requires user identity auth.
curl -X POST "https://apitree.ai/api/v1/proxy/kr-hometax-withholding-receipt" \
-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"