# 건축물대장 초본 발급 접수한 발급 작업의 진행 상태를 확인합니다. 문서가 준비되면 원본과 문서확인번호를 반환합니다. 인증: Authorization: Bearer $APICK_API_KEY 본문 있는 REST 요청: multipart/form-data. GET 본문 및 MCP JSON-RPC 규격은 해당 명세를 따릅니다. 인증키는 서버에 보관하세요. 모든 예제는 정적 자료입니다. ## POST /rest/get_building_register_cho 응답 필드 - `data` (object): 요청 처리 결과 묶음입니다. 조회한 값·작업 상태·오류 설명이 이 안에 들어 있으며, 실제 하위 필드 구성은 서비스마다 다릅니다. 값이 없으면 null·빈 배열·필드 생략 중 해당 서비스의 규칙을 따릅니다. - `data.schemaVersion` (string): 응답 스키마의 버전입니다. 현재 "1.0"으로 고정되어 있으며, 필드 구조가 바뀌면 값이 올라갑니다. 클라이언트는 이 값을 저장해 두고 파싱 로직을 분기할 수 있습니다. - `data.transactionId` (string): 간편인증 요청에서 발급된 거래 ID입니다. 인증요청 응답의 transactionId와 같으며, 같은 거래의 결과를 조회하거나 문의할 때 사용합니다. 인증이 만료되면 새 거래를 만들어야 합니다. - `data.product` (string): 조회한 상품 코드입니다. 인증요청 때 보낸 product와 같은 값이며, 응답의 result 구조를 해석할 때 기준이 됩니다. - `data.status` (string): 현재 처리 상태 코드입니다. 괄호 안 설명은 이 서비스에서의 상태 의미이며, 값별 다음 행동은 이 문서의 상태 표를 확인하세요. 상태가 바뀌면 같은 경로를 다시 조회합니다. 가능한 값은 9가지입니다. AUTH_REQUESTED = 인증 요청만 접수되어 사용자 승인을 기다리는 상태, AUTH_WAITING = 승인 전 대기, AUTH_COMPLETED = 승인은 끝났고 결과 준비 전, COLLECTING = 결과 준비 중, SUCCESS = 정상 완료되어 결과 사용 가능, PARTIAL_SUCCESS = 일부 자료만 준비되어 sources의 항목별 status 확인 필요, FAILED = 서버 처리 실패, AUTH_REJECTED = 사용자가 인증 거부, AUTH_EXPIRED = 승인 유효시간(300초) 만료입니다. - `data.resultAvailable` (boolean): 실제 결과 포함 여부. 과금 여부도 이 값으로 결정됩니다. true/false로 오며, 값이 없으면 필드가 생략되거나 null일 수 있습니다. true = 결과를 지금 사용할 수 있는 경우, false = 아직 처리 중이거나 실패·만료되어 결과가 없는 경우입니다. false면 data.status를 확인하세요. - `data.charged` (boolean): 이번 호출의 과금 발생 여부. 최초 결과 반환에서만 true 입니다. true/false로 오며, 값이 없으면 필드가 생략되거나 null일 수 있습니다. true = 이번 조회에서 포인트가 실제로 차감된 경우(유료 결과를 처음 받은 때), false = 이미 차감된 결과를 다시 조회했거나 무료 응답인 경우입니다. api.cost가 0이면 false입니다. - `data.sources` (array): 자료 항목별 처리 결과 목록입니다. 항목별 성공·실패를 구분하므로 일부만 성공한 응답을 판단할 때 사용합니다. - `data.sources[].source` (string): 자료 항목의 표시 이름입니다. type과 함께 어떤 자료인지 구분할 때 사용합니다. - `data.sources[].type` (string): 자료 유형 구분자입니다. 같은 상품 안에서 여러 종류의 자료를 묶어 받을 때 종류를 구분합니다. - `data.sources[].status` (string): 해당 자료 항목의 처리 상태입니다. SUCCESS는 정상, 그 외 값은 그 항목만 실패했거나 자료가 없음을 뜻합니다. 가능한 값은 2가지입니다. SUCCESS = 해당 자료 항목을 정상적으로 받은 경우, FAILED = 그 항목만 실패해 result에 그 자료가 빠진 경우입니다. 전체 status가 SUCCESS여도 항목별 FAILED가 있을 수 있습니다. - `data.message` (string): 안내 문구입니다. 오류 원인과 다음 행동을 설명합니다. 문자열로 오며, 값이 없으면 빈 문자열이거나 필드가 생략됩니다. 같은 응답의 다른 필드와 함께 해석하세요. - `data.expiresAt` (string): 이 응답이나 인증 요청의 유효 만료 시각입니다. 한국시간(UTC+09:00) ISO 8601 형식이며, 이 시각을 넘기면 같은 요청을 다시 접수해야 합니다. - `data.success` (integer): 업무 처리 결과 코드입니다. 1은 정상 결과, 0은 실패 또는 무료 응답입니다. 서비스에 따라 2·3처럼 추가 코드를 쓰므로 같은 응답의 status·msg·error 필드도 함께 확인하세요. - `data.progress` (object): 결과 준비 진행 상태 묶음입니다. 전체 자료 수와 완료된 자료 수를 담습니다. - `data.progress.total` (integer): 이번 조회에서 준비할 전체 자료 항목 수입니다. 여러 자료를 묶은 상품에서 진행률 계산의 분모로 사용합니다. - `data.progress.completed` (integer): 현재까지 준비를 마친 자료 항목 수입니다. total과 같아지면 모든 항목의 처리가 끝난 것입니다. - `data.checkedAt` (string): 실제 정보를 확인한 시각. 한국시간(UTC+09:00) ISO 8601 이며 재조회 유효기간의 기준입니다. - `data.resultExpiresAt` (string): 결과 재조회 만료 시각. 한국시간(UTC+09:00) ISO 8601 입니다. - `data.result` (object): 조회 결과 본문입니다. 서비스가 찾은 실제 데이터가 들어 있으며, 자료가 없거나 조회에 실패하면 null이거나 필드가 생략됩니다. - `data.result.buildingRegisterDocCho` (object): 이 조회 항목의 결과입니다. 항목은 결과 규격을 참고하세요. 하위 필드에 코드·이름·상태 같은 세부 값이 들어 있으며, 자료가 없으면 빈 객체이거나 생략됩니다. - `data.result.buildingRegisterDocCho.문서확인번호` (string): 발급된 건축물대장 초본의 문서확인번호 문자열로 오며, 값이 없으면 빈 문자열이거나 필드가 생략됩니다. 같은 응답의 다른 필드와 함께 해석하세요. - `data.result.buildingRegisterDocCho.발급일자` (string): 발급일자 문자열로 오며, 값이 없으면 빈 문자열이거나 필드가 생략됩니다. 같은 응답의 다른 필드와 함께 해석하세요. - `data.result.buildingRegisterDocCho.성명` (string): 발급 대상자 성명 문자열로 오며, 값이 없으면 빈 문자열이거나 필드가 생략됩니다. 같은 응답의 다른 필드와 함께 해석하세요. - `data.result.buildingRegisterDocCho.발급문서` (string): 발급된 PDF 원본을 base64 로 인코딩한 문자열. 그대로 디코딩하면 PDF 한 부가 된다. - `data.result.buildingRegisterDocCho.문서파일명` (string): 발급 문서의 원래 파일명 문자열로 오며, 값이 없으면 빈 문자열이거나 필드가 생략됩니다. 같은 응답의 다른 필드와 함께 해석하세요. - `data.result.buildingRegisterDocCho.문서해시` (string): 발급 문서의 SHA-256. 내려받은 파일과 대조할 수 있다. 문자열로 오며, 값이 없으면 빈 문자열이거나 필드가 생략됩니다. 같은 응답의 다른 필드와 함께 해석하세요. - `data.result.buildingRegisterDocCho.문서크기` (integer): 발급 문서의 바이트 크기 숫자로 오며, 단위·범위는 같은 응답의 다른 필드나 이 문서의 설명을 확인하세요. - `data.result.buildingRegisterDocCho.조회결과` (string): 발급이 거절되면 기관 안내 문구가 온다. 정상 발급이면 담기지 않는다. 문자열로 오며, 값이 없으면 빈 문자열이거나 필드가 생략됩니다. 같은 응답의 다른 필드와 함께 해석하세요. - `data.errorCode` (string): 오류 구분. RESULT_EXPIRED(재조회 기간 만료) / AUTH_EXPIRED / AUTH_REJECTED / COLLECT_FAILED / SERVICE_MAINTENANCE(기관이 서비스 점검·중지 중) 가능한 값은 5가지입니다. RESULT_EXPIRED = 결과 재조회 기간이 지난 경우(새로 인증해야 함), AUTH_EXPIRED = 승인 유효시간이 지난 경우, AUTH_REJECTED = 사용자가 인증을 거부한 경우, COLLECT_FAILED = 승인 뒤 결과 준비가 실패한 경우, SERVICE_MAINTENANCE = 기관이 서비스 점검(중지) 중이라 결과를 만들지 못한 경우입니다. SERVICE_MAINTENANCE 는 요청 오류가 아니므로 입력값을 고칠 필요가 없습니다. 오류가 없으면 null입니다. - `data.maintenance` (boolean): 기관이 서비스 점검(중지) 중이라 결과를 만들지 못한 경우에만 true 입니다. 요청 오류가 아니므로 입력값을 고칠 필요가 없고, 점검 시간이 끝난 뒤 다시 요청하세요. 값이 없거나 false 면 점검 때문이 아닙니다. 이때는 message 에 같은 안내가 들어옵니다. - `api` (object): API 호출 메타데이터입니다. 이번 요청의 서버 처리 성공 여부(api.success), 실제 차감 포인트(api.cost), 결제 기록 ID(api.pl_id)를 담습니다. 처리 시간(api.ms)은 응답에 포함된 경우에만 제공됩니다. 업무 결과는 data에서 확인합니다. - `api.success` (boolean): API 서버가 이번 요청을 정상 처리했는지 여부입니다. true여도 업무 결과가 실패일 수 있으므로 data.success·data.status와 함께 판단합니다. 인증 실패·잘못된 입력·서버 오류 응답에서는 false입니다. - `api.cost` (integer): 이번 호출에서 실제로 차감된 포인트입니다. 유료 성공 응답에서만 단가만큼 차감되며, 실패·무료 조회·같은 요청의 멱등 재전송은 0입니다. 화면의 표시 단가와 실제 차감액이 다를 수 있으므로 정산은 이 값을 기준으로 합니다. - `api.ms` (integer): 서버가 요청을 받아 응답 본문을 만들기까지 걸린 처리 시간(밀리초)입니다. 네트워크 왕복 시간과 클라이언트 대기 시간은 포함되지 않습니다. - `api.pl_id` (integer): 포인트 차감 기록 ID입니다. 차감이 발생한 호출에만 값이 있으며, 과금 내역을 문의할 때 이 번호를 사용합니다. 무과금 응답은 -1·null이거나 필드가 생략됩니다. ## API 요청: POST /rest/get_building_register_cho ### 입력 - `transactionId` (string, 필수): /rest/req_building_register_cho 가 반환한 트랜잭션 ID ### 응답 명세 ```json { "type": "object", "properties": { "data": { "type": "object", "properties": { "schemaVersion": { "type": "string", "description": "결과 스키마 버전 (고정값: \"1.0\")" }, "transactionId": { "type": "string", "description": "트랜잭션 ID" }, "product": { "type": "string", "description": "조회 항목 코드. 인증요청 응답과 같은 값입니다." }, "status": { "type": "string", "description": "처리 상태 (위 표 참고)" }, "resultAvailable": { "type": "boolean", "description": "실제 결과 포함 여부. 과금 여부도 이 값으로 결정됩니다." }, "charged": { "type": "boolean", "description": "이번 호출의 과금 발생 여부. 최초 결과 반환에서만 true 입니다." }, "sources": { "type": "array", "items": { "type": "object", "properties": { "source": { "type": "string" }, "type": { "type": "string" }, "status": { "type": "string" } } }, "description": "항상 포함됩니다. 값이 없으면 빈 배열 [] 입니다. 항목이 여러 개인 상품에서 어느 것이 성공·실패했는지 알려줍니다. 각 항목은 source(자료 이름), type(데이터 종류), status(SUCCESS/FAILED). 결과 준비가 끝나기 전에는 아직 확정되지 않은 항목이 FAILED 로 보일 수 있습니다." }, "message": { "type": "string", "description": "상태 메시지" }, "expiresAt": { "type": "string" }, "success": { "type": "integer", "description": "과금 여부0: 결과 없음 또는 재조회(무과금)1: 최초 결과 반환(과금)" }, "progress": { "type": "object", "properties": { "total": { "type": "integer" }, "completed": { "type": "integer" } }, "description": "진행률(COLLECTING 일 때). total(전체 항목), completed(완료 항목)" }, "checkedAt": { "type": "string", "description": "실제 정보를 확인한 시각. 한국시간(UTC+09:00) ISO 8601 이며 재조회 유효기간의 기준입니다." }, "resultExpiresAt": { "type": "string", "description": "결과 재조회 만료 시각. 한국시간(UTC+09:00) ISO 8601 입니다." }, "result": { "type": "object", "properties": { "buildingRegisterDocCho": { "type": "object", "properties": { "문서확인번호": { "type": "string", "description": "발급된 건축물대장 초본의 문서확인번호" }, "발급일자": { "type": "string", "description": "발급일자" }, "성명": { "type": "string", "description": "발급 대상자 성명" }, "발급문서": { "type": "string", "description": "발급된 PDF 원본을 base64 로 인코딩한 문자열. 그대로 디코딩하면 PDF 한 부가 된다." }, "문서파일명": { "type": "string", "description": "발급 문서의 원래 파일명" }, "문서해시": { "type": "string", "description": "발급 문서의 SHA-256. 내려받은 파일과 대조할 수 있다." }, "문서크기": { "type": "integer", "description": "발급 문서의 바이트 크기" }, "조회결과": { "type": "string", "description": "발급이 거절되면 기관 안내 문구가 온다. 정상 발급이면 담기지 않는다." } }, "description": "이 조회 항목의 결과입니다. 항목은 결과 규격을 참고하세요." } }, "description": "조회된 결과 묶음. 실제 데이터가 있을 때만 포함됩니다." }, "errorCode": { "type": "string", "description": "오류 구분. RESULT_EXPIRED(재조회 기간 만료) / AUTH_EXPIRED / AUTH_REJECTED / COLLECT_FAILED / SERVICE_MAINTENANCE(기관이 서비스 점검·중지 중)" }, "maintenance": { "type": "boolean", "description": "기관이 서비스 점검(중지) 중이라 결과를 만들지 못한 경우에만 true 입니다. 요청 오류가 아니므로 입력값을 고칠 필요가 없고, 점검 시간이 끝난 뒤 다시 요청하세요. 값이 없거나 false 면 점검 때문이 아닙니다. 이때는 message 에 같은 안내가 들어옵니다." } }, "description": "상태·결과" }, "api": { "type": "object", "properties": { "success": { "type": "boolean", "description": "API 서버 정상 응답 여부" }, "cost": { "type": "integer", "description": "API 호출 요금" }, "ms": { "type": "integer", "description": "API 응답 시간" }, "pl_id": { "type": "integer", "description": "API 결제 로그 ID" } }, "description": "API 호출 공통 데이터" } } } ``` ### 정적 응답 예시 ```json { "data": { "schemaVersion": "1.0", "transactionId": "9f2c4a7b1d8e35c60a4f7b2d1e9c803a", "product": "building_register_cho", "status": "COLLECTING", "resultAvailable": false, "charged": false, "sources": [], "message": "정보를 조회하고 있습니다.", "expiresAt": "2026-09-20T05:24:07+09:00", "success": 0 }, "api": { "success": true, "cost": 0, "ms": 42, "pl_id": -1 } } ``` ### 정적 응답 예시 ```json { "data": { "schemaVersion": "1.0", "transactionId": "9f2c4a7b1d8e35c60a4f7b2d1e9c803a", "product": "building_register_cho", "status": "COLLECTING", "resultAvailable": false, "charged": false, "sources": [], "progress": { "total": 1, "completed": 0 }, "message": "정보를 조회하고 있습니다.", "success": 0 }, "api": { "success": true, "cost": 0, "ms": 38, "pl_id": -1 } } ``` ### 정적 응답 예시 ```json { "data": { "schemaVersion": "1.0", "transactionId": "9f2c4a7b1d8e35c60a4f7b2d1e9c803a", "product": "building_register_cho", "status": "SUCCESS", "resultAvailable": true, "charged": true, "sources": [ { "source": "건축물대장 초본 발급", "type": "BUILDING_REGISTER_CHO", "status": "SUCCESS" } ], "checkedAt": "2026-09-20T04:47:33+09:00", "resultExpiresAt": "2026-09-21T04:47:33+09:00", "result": { "buildingRegisterDocCho": { "문서확인번호": "ABCD-EFGH-IJKL", "발급일자": "20250314", "성명": "홍길동", "발급문서": "JVBERi0xLjQK...", "문서파일명": "건축물대장(초본).pdf" } }, "message": "인증이 완료되었습니다.", "success": 1 }, "api": { "success": true, "cost": 80, "ms": 318, "pl_id": 4903 } } ``` ### curl ```curl curl --fail-with-body --request POST 'https://apick.app/rest/get_building_register_cho' \ --header "Authorization: Bearer $APICK_API_KEY" \ --form-string 'transactionId=9f2c4a7b1d8e35c60a4f7b2d1e9c803a' ``` ### Node.js (서버 ESM) ```javascript const form = new FormData(); form.append("transactionId", "9f2c4a7b1d8e35c60a4f7b2d1e9c803a"); const response = await fetch("https://apick.app/rest/get_building_register_cho", { method: "POST", headers: { Authorization: "Bearer " + process.env.APICK_API_KEY }, body: form, signal: AbortSignal.timeout(120_000), }); if (!response.ok) throw new Error(`HTTP ${response.status}: ${await response.text()}`); const result = await response.json(); console.log(result); ``` ### python ```python import os import requests parts = [ ("transactionId", (None, "9f2c4a7b1d8e35c60a4f7b2d1e9c803a")), ] response = requests.request("POST", "https://apick.app/rest/get_building_register_cho", headers={"Authorization": "Bearer " + os.environ["APICK_API_KEY"]}, files=parts, timeout=(10, 120)) response.raise_for_status() result = response.json() print(result) ``` ### php ```php '9f2c4a7b1d8e35c60a4f7b2d1e9c803a', ]; $curl = curl_init('https://apick.app/rest/get_building_register_cho'); curl_setopt_array($curl, [ CURLOPT_CUSTOMREQUEST => 'POST', CURLOPT_HTTPHEADER => $headers, CURLOPT_POSTFIELDS => $form, CURLOPT_RETURNTRANSFER => true, CURLOPT_CONNECTTIMEOUT => 10, CURLOPT_TIMEOUT => 120, ]); $body = curl_exec($curl); if ($body === false) { throw new RuntimeException(curl_error($curl)); } $status = curl_getinfo($curl, CURLINFO_HTTP_CODE); curl_close($curl); if ($status >= 400) { throw new RuntimeException($body); } $result = json_decode($body, true, 512, JSON_THROW_ON_ERROR); print_r($result); ``` ## 코드·오류 ### 업무 실패 응답 입력 오류·대상 없음·일시 실패는 data.error(사유)와 data.success=0으로 오며 api.cost는 0(과금 없음)입니다. HTTP 상태는 400·404·408·424 중 하나입니다. 입력 오류는 값을 고쳐 다시 요청하고, 408·424는 잠시 후 한 번 다시 시도하세요. ```json { "data": { "error": "입력값을 확인해 주세요.", "success": 0 }, "api": { "success": true, "cost": 0, "ms": 5 } } ``` ## 상세 기능·요금 2단계 · 결과조회 엔드포인트 Method URL POST https://apick.app/rest/get_building_register_cho 이 API 는 polling 용도입니다. 호출 자체는 언제든 무료이며, 실제 결과가 최초로 반환되는 1회에만 과금됩니다. 같은 transactionId 로 다시 조회하면 charged=false 로 추가 과금이 없습니다. 인증 대기(AUTH_WAITING)·조회 중(COLLECTING)·실패(FAILED)·만료(AUTH_EXPIRED) 응답은 과금되지 않습니다. 결과를 받을 때까지 안심하고 반복 조회하세요. 결과가 준비된 뒤에는 조회 시각 기준 24시간 동안 재조회할 수 있습니다. 이 기간의 재조회는 무과금입니다. 응답에는 실제 정보를 확인한 시각이 checkedAt 으로 포함됩니다. 저장해 둔 값을 돌려주는 것이 아니라 그 시점에 확인한 값입니다. 폴링은 resultAvailable=true 를 받는 순간 멈추세요. 최대 시간은 expiresAt(인증 대기)까지이고, 그 뒤로는 결과가 나올 때까지입니다. 자세한 값은 호출 제한과 재시도를 참고하세요. 조회 항목이 여러 개인 상품은 일부만 성공하면 PARTIAL_SUCCESS 로 반환하며, 이때도 실제 조회된 데이터가 있으면 최초 1회 과금됩니다. 기본은 결과 단가 전액이지만, 선택형 묶음은 요청에서 고른 조회 중 실제 받은 항목의 단가만 합산하고, 발급형 증명은 문서를 받은 항목만 청구합니다. 문서 미수신·기관 거절·PDF 파싱 실패는 무과금이며, 받은 항목이 하나도 없으면 charged=false·cost 0 으로 응답합니다. 어느 항목이 성공·실패했는지는 sources 에 표시됩니다. 결과조회를 호출할 때마다 보유 포인트가 이 상품의 결과 단가 이상인지 먼저 확인합니다. 모자라면 인증 대기 중이어도 HTTP 200 과 result.error(사용 가능한 포인트이 부족합니다.)로 거절되고 과금되지 않으므로, 충전한 뒤 같은 transactionId 로 다시 조회하세요. 결과 단가는 건당 80P입니다. 이 상품은 조회 기간 입력이 없어 기간 배수가 적용되지 않습니다. ## 상세 요청 Header 이름 필수 설명 Authorization O Bearer 인증키 본문은 transactionId 하나입니다. 결과조회 엔드포인트는 인증요청과 짝이 되는 /rest/get_building_register_cho 이며, 다른 항목의 엔드포인트로 조회하면 실패합니다. 조회 시각 기준 24시간이 지나면 RESULT_EXPIRED 가 반환됩니다. 이때는 발급을 다시 접수해야 하며, 접수 단가가 다시 발생합니다. 요청 예시 form-data 전체 예제 보기 ## 상세 응답 처리 상태(status) 값 의미 과금 AUTH_REQUESTED 발급 접수 (/rest/req_building_register_cho 응답) 접수 시 과금 COLLECTING 조회 결과를 준비하는 중 무과금 SUCCESS 모든 항목 조회 완료 최초 1회만 PARTIAL_SUCCESS 일부 항목만 조회 완료 (sources 참고) 최초 1회 — 선택형 묶음·발급형은 받은 항목 단가만, 받은 항목이 없으면 무과금 FAILED 조회 실패 (기관 서비스 점검·중지 포함) 무과금 Body 이름 타입 설명 data Object 상태·결과 schemaVersion String 결과 스키마 버전 (고정값: "1.0") transactionId String 트랜잭션 ID product String 조회 항목 코드. 인증요청 응답과 같은 값입니다. status String 처리 상태 (위 표 참고) resultAvailable Boolean 실제 결과 포함 여부. 과금 여부도 이 값으로 결정됩니다. charged Boolean 이번 호출의 과금 발생 여부. 최초 결과 반환에서만 true 입니다. sources Array 항상 포함됩니다. 값이 없으면 빈 배열 [] 입니다. 항목이 여러 개인 상품에서 어느 것이 성공·실패했는지 알려줍니다. 각 항목은 source(자료 이름), type(데이터 종류), status(SUCCESS/FAILED). 결과 준비가 끝나기 전에는 아직 확정되지 않은 항목이 FAILED 로 보일 수 있습니다. progress Object 진행률(COLLECTING 일 때). total(전체 항목), completed(완료 항목) checkedAt String 실제 정보를 확인한 시각. 한국시간(UTC+09:00) ISO 8601 이며 재조회 유효기간의 기준입니다. resultExpiresAt String 결과 재조회 만료 시각. 한국시간(UTC+09:00) ISO 8601 입니다. errorCode String 오류 구분. RESULT_EXPIRED(재조회 기간 만료) / AUTH_EXPIRED / AUTH_REJECTED / COLLECT_FAILED / SERVICE_MAINTENANCE(기관이 서비스 점검·중지 중) maintenance Boolean 기관이 서비스 점검(중지) 중이라 결과를 만들지 못한 경우에만 true 입니다. 요청 오류가 아니므로 입력값을 고칠 필요가 없고, 점검 시간이 끝난 뒤 다시 요청하세요. 값이 없거나 false 면 점검 때문이 아닙니다. 이때는 message 에 같은 안내가 들어옵니다. result Object 조회된 결과 묶음. 실제 데이터가 있을 때만 포함됩니다. buildingRegisterDocCho Object 이 조회 항목의 결과입니다. 항목은 결과 규격을 참고하세요. message String 상태 메시지 success Integer 과금 여부0: 결과 없음 또는 재조회(무과금)1: 최초 결과 반환(과금) api Object API 호출 공통 데이터 success Boolean API 서버 정상 응답 여부 cost Integer API 호출 요금 ms Integer API 응답 시간 pl_id Integer API 결제 로그 ID 결과 규격 result.buildingRegisterDocCho 경로 타입 값 존재 설명 예시 문서확인번호 String O 발급된 건축물대장 초본의 문서확인번호 ABCD-EFGH-IJKL 발급일자 String(YYYYMMDD) O 발급일자 20250314 성명 String O 발급 대상자 성명 홍길동 발급문서 String O 발급된 PDF 원본을 base64 로 인코딩한 문자열. 그대로 디코딩하면 PDF 한 부가 된다. JVBERi0xLjQK... 문서파일명 String O 발급 문서의 원래 파일명 건축물대장(초본).pdf 문서해시 String 조건부 발급 문서의 SHA-256. 내려받은 파일과 대조할 수 있다. 9f2c4a7b1d8e35c60a4f7b2d1e9c803a9f2c4a7b1d8e35c60a4f7b2d1e9c803a 문서크기 Integer 조건부 발급 문서의 바이트 크기 165432 조회결과 String 조건부 발급이 거절되면 기관 안내 문구가 온다. 정상 발급이면 담기지 않는다. 발급 대상이 아닙니다. 타입 읽는 법 — String 은 문자열, Integer 는 소수점 없는 정수(원 단위 금액 포함), Boolean 은 true/false, Object 는 이름이 있는 하위 항목 묶음, Array 는 같은 구조가 여러 건 오는 목록, Array 은 문자열 목록입니다. String(YYYY-MM-DD) 처럼 괄호가 붙으면 그 형식의 문자열이라는 뜻이고 날짜 타입이 아닙니다. 값 존재 — O는 정상 결과에 있는 항목, 조건부는 해당 정보가 있을 때 제공하는 항목입니다. 누락·빈 문자열·빈 배열·0·null의 의미는 항목별 설명을 따릅니다. 부모 항목이 없으면 그 하위 항목도 없습니다. 예시 — 응답에 들어오는 형태 그대로의 값입니다. 실제 조회 결과가 아니며 개인을 특정할 수 없는 가상의 값입니다. 이 열이 비어 있으면 하위 항목이 있는 묶음이거나 값이 빠질 수 있는 항목입니다. 들여쓰기된 항목은 바로 위 부모 안에 들어 있는 하위 항목입니다. 경로 표기에서 . 는 하위 항목, [ ] 를 붙인 항목은 그 안에 여러 건이 오는 목록이라는 뜻입니다. ## 상세 예제 조회 중 (무과금) { "data": { "schemaVersion": "1.0", "transactionId": "9f2c4a7b1d8e35c60a4f7b2d1e9c803a", "product": "building_register_cho", "status": "COLLECTING", "resultAvailable": false, "charged": false, "sources": [], "message": "정보를 조회하고 있습니다.", "expiresAt": "2026-09-20T05:24:07+09:00", "success": 0 }, "api": { "success": true, "cost": 0, "ms": 42, "pl_id": -1 } } 조회 중 (무과금) { "data": { "schemaVersion": "1.0", "transactionId": "9f2c4a7b1d8e35c60a4f7b2d1e9c803a", "product": "building_register_cho", "status": "COLLECTING", "resultAvailable": false, "charged": false, "sources": [], "progress": { "total": 1, "completed": 0 }, "message": "정보를 조회하고 있습니다.", "success": 0 }, "api": { "success": true, "cost": 0, "ms": 38, "pl_id": -1 } } 조회 완료 (과금) { "data": { "schemaVersion": "1.0", "transactionId": "9f2c4a7b1d8e35c60a4f7b2d1e9c803a", "product": "building_register_cho", "status": "SUCCESS", "resultAvailable": true, "charged": true, "sources": [ { "source": "건축물대장 초본 발급","type": "BUILDING_REGISTER_CHO", "status": "SUCCESS" } ], "checkedAt": "2026-09-20T04:47:33+09:00", "resultExpiresAt": "2026-09-21T04:47:33+09:00", "result": { "buildingRegisterDocCho": { "문서확인번호": "ABCD-EFGH-IJKL", "발급일자": "20250314", "성명": "홍길동", "발급문서": "JVBERi0xLjQK...", "문서파일명": "건축물대장(초본).pdf" } }, "message": "인증이 완료되었습니다.", "success": 1 }, "api": { "success": true, "cost": 80, "ms": 318, "pl_id": 4903 } } 위 값은 응답 구조를 보여주기 위한 예시입니다. 값은 가상이지만 필드 구성과 타입은 실제 응답과 같습니다. 전체 항목은 결과 규격을 참고하세요. expiresAt 은 SUCCESS 응답에 없습니다. 인증 대기 기한(AUTH_WAITING)에만 있고, 결과를 받은 뒤에는 resultExpiresAt 이 그 역할을 대신합니다. 둘 중 어느 것이 오는지로 "지금이 승인 대기인지 결과 보관 기간인지"를 구분할 수 있습니다.