# 법원 경매 사건 조회 법원 경매 사건번호와 법원으로 사건 기본정보·매각기일·감정평가액·최저매각가격·진행상태를 조회합니다. 인증: Authorization: Bearer $APICK_API_KEY 본문 있는 REST 요청: multipart/form-data. GET 본문 및 MCP JSON-RPC 규격은 해당 명세를 따릅니다. 인증키는 서버에 보관하세요. 모든 예제는 정적 자료입니다. ## POST /rest/court_auction 응답 필드 - `data` (object): 요청 처리 결과 묶음입니다. 조회한 값·작업 상태·오류 설명이 이 안에 들어 있으며, 실제 하위 필드 구성은 서비스마다 다릅니다. 값이 없으면 null·빈 배열·필드 생략 중 해당 서비스의 규칙을 따릅니다. - `data.result` (integer): 조회 결과 본문입니다. 서비스가 찾은 실제 데이터가 들어 있으며, 자료가 없거나 조회에 실패하면 null이거나 필드가 생략됩니다. - `data.msg` (string): 처리 결과를 사람이 읽을 수 있는 문장으로 설명합니다. 성공·실패 사유가 담기며, 오류 코드는 별도 필드에서 확인합니다. - `data.success` (integer): 업무 처리 결과 코드입니다. 1은 정상 결과, 0은 실패 또는 무료 응답입니다. 서비스에 따라 2·3처럼 추가 코드를 쓰므로 같은 응답의 status·msg·error 필드도 함께 확인하세요. - `data.case` (object): 사건 기본정보 하위 필드에 코드·이름·상태 같은 세부 값이 들어 있으며, 자료가 없으면 빈 객체이거나 생략됩니다. - `data.case.caseNo` (string): 사건번호 문자열로 오며, 값이 없으면 빈 문자열이거나 필드가 생략됩니다. 같은 응답의 다른 필드와 함께 해석하세요. - `data.case.court` (string): 법원 문자열로 오며, 값이 없으면 빈 문자열이거나 필드가 생략됩니다. 같은 응답의 다른 필드와 함께 해석하세요. - `data.case.caseName` (string): 사건명 (예: 부동산강제경매) 문자열로 오며, 값이 없으면 빈 문자열이거나 필드가 생략됩니다. 같은 응답의 다른 필드와 함께 해석하세요. - `data.case.receivedAt` (string): 접수일 (YYYY-MM-DD) 문자열로 오며, 값이 없으면 빈 문자열이거나 필드가 생략됩니다. 같은 응답의 다른 필드와 함께 해석하세요. - `data.case.claimAmount` (integer): 청구금액 (원) 숫자로 오며, 단위·범위는 같은 응답의 다른 필드나 이 문서의 설명을 확인하세요. - `data.case.judgeDept` (string): 재판부 (경매계) 문자열로 오며, 값이 없으면 빈 문자열이거나 필드가 생략됩니다. 같은 응답의 다른 필드와 함께 해석하세요. - `data.case.judgeDeptTel` (string): 재판부 전화번호 문자열로 오며, 값이 없으면 빈 문자열이거나 필드가 생략됩니다. 같은 응답의 다른 필드와 함께 해석하세요. - `data.case.executorTel` (string): 집행관 전화번호 문자열로 오며, 값이 없으면 빈 문자열이거나 필드가 생략됩니다. 같은 응답의 다른 필드와 함께 해석하세요. - `data.case.auctionStatus` (string): 사건 진행 상태 (진행중·종결) 문자열로 오며, 값이 없으면 빈 문자열이거나 필드가 생략됩니다. 같은 응답의 다른 필드와 함께 해석하세요. - `data.case.completedAt` (string): 종결일 (없으면 빈 값) 문자열로 오며, 값이 없으면 빈 문자열이거나 필드가 생략됩니다. 같은 응답의 다른 필드와 함께 해석하세요. - `data.case.suspended` (boolean): 진행정지 여부 true/false로 오며, 값이 없으면 필드가 생략되거나 null일 수 있습니다. true = 이 필드가 나타내는 조건이 성립한 경우, false = 성립하지 않은 경우입니다. 두 값 모두 정상 응답에 올 수 있으며, 값이 없으면 필드가 생략되거나 null일 수 있습니다. - `data.case.suspensionReason` (string): 진행정지 사유 문자열로 오며, 값이 없으면 빈 문자열이거나 필드가 생략됩니다. 같은 응답의 다른 필드와 함께 해석하세요. - `data.items` (array): 조회 결과 항목 목록입니다. 항목이 없으면 빈 배열이며, 각 항목의 필드 구성은 서비스마다 다릅니다. - `data.items[].itemNo` (integer): 물건 번호 숫자로 오며, 단위·범위는 같은 응답의 다른 필드나 이 문서의 설명을 확인하세요. - `data.items[].address` (string): 장소의 도로명·지번 주소입니다. 여러 줄이면 줄바꿈이 포함될 수 있습니다. - `data.items[].propertyKind` (string): 물건 종류 (예: 집합건물) 문자열로 오며, 값이 없으면 빈 문자열이거나 필드가 생략됩니다. 같은 응답의 다른 필드와 함께 해석하세요. - `data.items[].appraisedPrice` (integer): 감정평가액 (원) 숫자로 오며, 단위·범위는 같은 응답의 다른 필드나 이 문서의 설명을 확인하세요. - `data.items[].minimumPrice` (integer): 최저매각가격 (원) 숫자로 오며, 단위·범위는 같은 응답의 다른 필드나 이 문서의 설명을 확인하세요. - `data.items[].failedCount` (integer): 유찰 횟수 숫자로 오며, 단위·범위는 같은 응답의 다른 필드나 이 문서의 설명을 확인하세요. - `data.items[].saleDate` (string): 매각기일 (YYYY-MM-DD) 문자열로 오며, 값이 없으면 빈 문자열이거나 필드가 생략됩니다. 같은 응답의 다른 필드와 함께 해석하세요. - `data.items[].saleTime` (string): 매각시간 (HH:MM) 문자열로 오며, 값이 없으면 빈 문자열이거나 필드가 생략됩니다. 같은 응답의 다른 필드와 함께 해석하세요. - `data.items[].depositRate` (integer): 입찰보증금 비율 (%) 숫자로 오며, 단위·범위는 같은 응답의 다른 필드나 이 문서의 설명을 확인하세요. - `data.saleSchedule` (array): 매각기일별 묶음 (saleDate·saleTime·items) 각 항목의 구성은 서비스에 따라 다르며, 값이 없으면 빈 배열입니다. 항목 수와 순서를 함께 확인하세요. - `data.saleSchedule[].saleDate` (string): 'saleDate' 문자열 값입니다. 값이 없으면 빈 문자열이거나 필드가 생략됩니다. - `data.saleSchedule[].saleTime` (string): 'saleTime' 문자열 값입니다. 값이 없으면 빈 문자열이거나 필드가 생략됩니다. - `data.saleSchedule[].items` (array): 'items' 목록입니다. 각 항목의 구성은 서비스에 따라 다르며, 값이 없으면 빈 배열입니다. - `data.saleSchedule[].items[].itemNo` (integer): 'itemNo' 수치 값입니다. 단위·범위는 같은 응답의 다른 필드나 이 문서의 설명을 확인하세요. - `data.saleSchedule[].items[].minimumPrice` (integer): 'minimumPrice' 수치 값입니다. 단위·범위는 같은 응답의 다른 필드나 이 문서의 설명을 확인하세요. - `data.claimDeadline` (string): 배당요구종기일 (YYYY-MM-DD) 문자열로 오며, 값이 없으면 빈 문자열이거나 필드가 생략됩니다. 같은 응답의 다른 필드와 함께 해석하세요. - `data.relatedCases` (array): 관련 사건 (caseNo·court·kind) 각 항목의 구성은 서비스에 따라 다르며, 값이 없으면 빈 배열입니다. 항목 수와 순서를 함께 확인하세요. - `data.relatedCases[].caseNo` (string): 'caseNo' 문자열 값입니다. 값이 없으면 빈 문자열이거나 필드가 생략됩니다. - `data.relatedCases[].court` (string): 'court' 문자열 값입니다. 값이 없으면 빈 문자열이거나 필드가 생략됩니다. - `data.relatedCases[].kind` (string): 'kind' 문자열 값입니다. 값이 없으면 빈 문자열이거나 필드가 생략됩니다. - `data.count` (integer): 건수입니다. 0이면 해당 항목이 없습니다. 숫자로 오며, 단위·범위는 같은 응답의 다른 필드나 이 문서의 설명을 확인하세요. - `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/court_auction ### 입력 - `case_no` (string, 필수): 사건번호 (예: 2024타경12345) — 연도·사건부호·번호 문자열로 보내며, 생략하면 서버 기본값이 적용되거나 해당 조건이 해제됩니다. - `court` (string, 필수): 법원 이름 또는 법원 코드 (예: 서울중앙지방법원) 문자열로 보내며, 생략하면 서버 기본값이 적용되거나 해당 조건이 해제됩니다. ### 응답 명세 ```json { "type": "object", "properties": { "data": { "type": "object", "properties": { "result": { "type": "integer", "description": "조회 결과1: 사건 있음" }, "msg": { "type": "string", "description": "결과 메시지" }, "success": { "type": "integer", "description": "과금 여부0: 실패1: 성공" }, "case": { "type": "object", "properties": { "caseNo": { "type": "string", "description": "사건번호" }, "court": { "type": "string", "description": "법원" }, "caseName": { "type": "string", "description": "사건명 (예: 부동산강제경매)" }, "receivedAt": { "type": "string", "description": "접수일 (YYYY-MM-DD)" }, "claimAmount": { "type": "integer", "description": "청구금액 (원)" }, "judgeDept": { "type": "string", "description": "재판부 (경매계)" }, "judgeDeptTel": { "type": "string", "description": "재판부 전화번호" }, "executorTel": { "type": "string", "description": "집행관 전화번호" }, "auctionStatus": { "type": "string", "description": "사건 진행 상태 (진행중·종결)" }, "completedAt": { "type": "string", "description": "종결일 (없으면 빈 값)" }, "suspended": { "type": "boolean", "description": "진행정지 여부" }, "suspensionReason": { "type": "string", "description": "진행정지 사유" } }, "description": "사건 기본정보" }, "items": { "type": "array", "items": { "type": "object", "properties": { "itemNo": { "type": "integer", "description": "물건 번호" }, "address": { "type": "string", "description": "소재지" }, "propertyKind": { "type": "string", "description": "물건 종류 (예: 집합건물)" }, "appraisedPrice": { "type": "integer", "description": "감정평가액 (원)" }, "minimumPrice": { "type": "integer", "description": "최저매각가격 (원)" }, "failedCount": { "type": "integer", "description": "유찰 횟수" }, "saleDate": { "type": "string", "description": "매각기일 (YYYY-MM-DD)" }, "saleTime": { "type": "string", "description": "매각시간 (HH:MM)" }, "depositRate": { "type": "integer", "description": "입찰보증금 비율 (%)" } } }, "description": "매각물건 목록" }, "saleSchedule": { "type": "array", "items": { "type": "object", "properties": { "saleDate": { "type": "string" }, "saleTime": { "type": "string" }, "items": { "type": "array", "items": { "type": "object", "properties": { "itemNo": { "type": "integer" }, "minimumPrice": { "type": "integer" } } } } } }, "description": "매각기일별 묶음 (saleDate·saleTime·items)" }, "claimDeadline": { "type": "string", "description": "배당요구종기일 (YYYY-MM-DD)" }, "relatedCases": { "type": "array", "items": { "type": "object", "properties": { "caseNo": { "type": "string" }, "court": { "type": "string" }, "kind": { "type": "string" } } }, "description": "관련 사건 (caseNo·court·kind)" }, "count": { "type": "integer", "description": "매각물건 수" } }, "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": { "result": 1, "msg": "경매 사건정보를 조회했습니다.", "success": 1, "case": { "caseNo": "2025타경104697", "court": "서울중앙지방법원", "caseName": "부동산강제경매", "receivedAt": "2025-12-24", "claimAmount": 320000000, "judgeDept": "경매12계", "judgeDeptTel": "02-3485-3244", "executorTel": "02-533-6852", "auctionStatus": "진행중", "completedAt": "", "suspended": false, "suspensionReason": "" }, "items": [ { "itemNo": 1, "address": "서울특별시 동작구 상도동 256-31 4층402호", "propertyKind": "집합건물", "appraisedPrice": 349000000, "minimumPrice": 349000000, "failedCount": 0, "saleDate": "2026-10-22", "saleTime": "10:00", "depositRate": 10 } ], "saleSchedule": [ { "saleDate": "2026-10-22", "saleTime": "10:00", "items": [ { "itemNo": 1, "minimumPrice": 349000000 } ] } ], "claimDeadline": "2026-04-06", "relatedCases": [ { "caseNo": "2023차전7941", "court": "인천지방법원 부천지원", "kind": "지급명령" } ], "count": 1 }, "api": { "success": true, "cost": 60, "ms": 3128, "pl_id": 8417712 } } ``` ### curl ```curl curl --fail-with-body --request POST 'https://apick.app/rest/court_auction' \ --header "Authorization: Bearer $APICK_API_KEY" \ --form-string 'case_no=2025타경104697' \ --form-string 'court=서울중앙지방법원' ``` ### Node.js (서버 ESM) ```javascript const form = new FormData(); form.append("case_no", "2025타경104697"); form.append("court", "서울중앙지방법원"); const response = await fetch("https://apick.app/rest/court_auction", { 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 = [ ("case_no", (None, "2025타경104697")), ("court", (None, "서울중앙지방법원")), ] response = requests.request("POST", "https://apick.app/rest/court_auction", headers={"Authorization": "Bearer " + os.environ["APICK_API_KEY"]}, files=parts, timeout=(10, 120)) response.raise_for_status() result = response.json() print(result) ``` ### php ```php '2025타경104697', 'court' => '서울중앙지방법원', ]; $curl = curl_init('https://apick.app/rest/court_auction'); 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 } } ``` ## 상세 기능·요금 Method URL POST https://apick.app/rest/court_auction 참고 사건번호는 법원마다 관리되므로 법원을 함께 입력해야 합니다. 법원은 이름 또는 법원 코드(B000210)로 지정할 수 있고, 이름은 앞부분만 넣어도 하나로 특정되면 조회됩니다. 사건번호만으로 법원을 추정하지 않습니다. 법원이 다르면 같은 사건번호라도 사건이 없을 수 있습니다. 입찰대행, 입찰서 작성·제출은 제공하지 않습니다. 실제 입찰 전에는 법원 매각공고와 매각물건명세서를 직접 확인해야 합니다. ## 상세 요청 Header 이름 필수 설명 Authorization O Bearer 인증키 ## 상세 응답 Body 이름 타입 설명 data Object 조회 데이터 result Integer 조회 결과1: 사건 있음 msg String 결과 메시지 success Integer 과금 여부0: 실패1: 성공 case Object 사건 기본정보 caseNo String 사건번호 court String 법원 caseName String 사건명 (예: 부동산강제경매) receivedAt String 접수일 (YYYY-MM-DD) claimAmount Integer 청구금액 (원) judgeDept String 재판부 (경매계) judgeDeptTel String 재판부 전화번호 executorTel String 집행관 전화번호 auctionStatus String 사건 진행 상태 (진행중·종결) completedAt String 종결일 (없으면 빈 값) suspended Boolean 진행정지 여부 suspensionReason String 진행정지 사유 items Array 매각물건 목록 itemNo Integer 물건 번호 address String 소재지 propertyKind String 물건 종류 (예: 집합건물) appraisedPrice Integer 감정평가액 (원) minimumPrice Integer 최저매각가격 (원) failedCount Integer 유찰 횟수 saleDate String 매각기일 (YYYY-MM-DD) saleTime String 매각시간 (HH:MM) depositRate Integer 입찰보증금 비율 (%) saleSchedule Array 매각기일별 묶음 (saleDate·saleTime·items) claimDeadline String 배당요구종기일 (YYYY-MM-DD) relatedCases Array 관련 사건 (caseNo·court·kind) count Integer 매각물건 수 api Object API 호출 공통 데이터 success Boolean API 서버 정상 응답 여부 cost Integer API 호출 요금 ms Integer API 응답 시간 pl_id Integer API 결제 로그 ID ## 상세 예제 요청 예시 form-data 전체 예제 보기 응답 예시 { "data": { "result": 1, "msg": "경매 사건정보를 조회했습니다.", "success": 1, "case": { "caseNo": "2025타경104697", "court": "서울중앙지방법원", "caseName": "부동산강제경매", "receivedAt": "2025-12-24", "claimAmount": 320000000, "judgeDept": "경매12계", "judgeDeptTel": "02-3485-3244", "executorTel": "02-533-6852", "auctionStatus": "진행중", "completedAt": "", "suspended": false, "suspensionReason": "" }, "items": [ { "itemNo": 1, "address": "서울특별시 동작구 상도동 256-31 4층402호", "propertyKind": "집합건물", "appraisedPrice": 349000000, "minimumPrice": 349000000, "failedCount": 0, "saleDate": "2026-10-22", "saleTime": "10:00", "depositRate": 10 } ], "saleSchedule": [ { "saleDate": "2026-10-22", "saleTime": "10:00", "items": [ { "itemNo": 1, "minimumPrice": 349000000 } ] } ], "claimDeadline": "2026-04-06", "relatedCases": [ { "caseNo": "2023차전7941", "court": "인천지방법원 부천지원", "kind": "지급명령" } ], "count": 1 }, "api": { "success": true, "cost": 60, "ms": 3128, "pl_id": 8417712 } } 호출 예시 같은 요청을 JavaScript와 Python으로 옮긴 예시입니다. 키는 환경변수 APICK_API_KEY 에서 읽습니다. JavaScript 예시 form-data 전체 예제 보기 Python 예시 form-data 전체 예제 보기