조회 API 는 상품마다 엔드포인트가 따로 있고, 그 아래 계약·요금·상태 규칙은 모두 같습니다. 이 페이지에서 한 번만 읽고, 상품별 입력과 결과 항목은 각 상품 페이지에서 확인하세요.
조회는 인증요청 → 인증대기 → 사용자인증완료 → 정보조회 → 정보제공 5단계입니다. 과금은 1단계(인증요청 발송 성공) 와 5단계(결과 최초 제공) 두 번만 발생하고, 그 사이 조회는 몇 번을 호출해도 무과금입니다.
checkedAt)입니다. 응답의 resultExpiresAt을 확인하고 받은 자료를 즉시 보관하세요.errorCode=RESULT_EXPIRED로 구분합니다. 새 인증·조회에는 각 단계의 과금 조건이 다시 적용됩니다.
동일 APICK 계정·같은 상품의 진행 중 요청 또는 최근 30초 내 요청이 있으면 인증을 재발송하지 않고 기존 transactionId 를 그대로 반환합니다. 이때는 success=0, charged=false 로 돌아오며 과금되지 않습니다. 중복 판정은 조회 대상자의 이름·전화번호가 아닌 계정·상품 기준입니다. 다른 대상자의 인증을 동시에 요청하지 마세요.
Content-Type: multipart/form-data)로 보냅니다.
기존 레거시 API와 같은 규격입니다.
요청 본문 형식을 참고하세요.아래 순서대로 구현하면 조회 상품 하나를 연동할 수 있습니다.
실제 고객 연동에서 자주 나오는 질문입니다. 이 항목들을 먼저 정하면 시행착오를 줄일 수 있습니다.
Authorization: Bearer 에 마이페이지에 표시된 인증키 값을 그대로 넣으세요. 서버 환경변수에 두고 브라우저·앱 클라이언트에는 넣지 마세요. 노출이 의심되면 마이페이지에서 재발급하면 기존 키는 즉시 무효가 됩니다.multipart/form-data)로 보내세요. 입력은 name·birthDate·phone 처럼 최상위 이름 그대로 보냅니다.api.cost=0). 이때는 과금되지 않습니다.2026-09-20T05:24:07+09:00 처럼 오프셋이 붙어 오므로 그대로 표시하면 됩니다.조회는 인증요청 20P 와 결과 단가 두 번 과금됩니다. 포인트가 부족하면 거절되고 그 호출은 과금되지 않습니다(호출 전 잔액 확인은 HTTP 200 과 result.error, 결과 청구 시점은 HTTP 402 와 data.error).
결과가 준비되지 않은 대기 조회에는 간격을 두세요. 실제 비용은 각 응답의 api.cost로 확인합니다. 결과를 받은 뒤에는 폴링을 멈추는 것이 가장 중요합니다.
아래 상품마다 /rest/req_<항목> 과 /rest/get_<항목> 두 엔드포인트가 있습니다. 상품을 고르면 입력 항목·결과 규격·예시를 볼 수 있습니다. 상품 소개와 요금을 한눈에 보려면 간편인증 통합조회 소개를 보세요.
/rest/req_nps_deduction_cert/rest/get_nps_deduction_cert/rest/req_cash_receipt_deduction/rest/get_cash_receipt_deduction/rest/req_tax_payment_history/rest/get_tax_payment_history/rest/req_business_registration_cert/rest/get_business_registration_cert/rest/req_housing_refund_balance/rest/get_housing_refund_balance인증요청·결과조회 모두 POST + form-data 입니다. 입력은 모두 최상위 이름으로 보내며, 아래 형식 하나만 씁니다.
multipart/form-dataname=홍길동&birthDate=19900101&phone=01012345678&authProvider=kakaouser·requestData·options 로 묶지 마세요. 조회 조건과 조회 기간도 docNo·customerNo·years 처럼 최상위 이름 그대로 보냅니다.
이름은 birthDate 대신 birthday, authProvider 대신 provider 로 보내도 같은 값으로 인정됩니다. 문서·코드·테스트는 birthDate·authProvider 로 통일합니다.
아래 항목은 조회 항목과 무관하게 공통으로 발생합니다. 오류 응답은 과금되지 않습니다.
api.cost=0api.cost=0api.cost=0api.success=true 입니다. 과금 여부는 api.cost 와 data.charged 로 판단하세요.
필드가 여러 곳에 흩어져 있어 "무엇으로 성공을 판단해야 하는가" 가 가장 많이 나오는 질문입니다. 결론은 data.status 와 data.resultAvailable 두 개입니다.
data.resultAvailable === true이고 상태가 SUCCESS 또는 PARTIAL_SUCCESS 이면 성공입니다. resultAvailable=false인 경우 진행 중이거나 종료이며, 종료 상태는 사용자에게 다시 시도할지 물어보세요.