{"openapi":"3.0.3","info":{"title":"APICK 법원 경매 사건 조회","version":"1.0.0","description":"법원 경매 사건번호와 법원으로 사건 기본정보·매각기일·감정평가액·최저매각가격·진행상태를 조회합니다."},"servers":[{"url":"https://apick.app"}],"paths":{"/rest/court_auction":{"post":{"summary":"법원 경매 사건 조회","description":"법원 경매 사건번호와 법원으로 사건 기본정보·매각기일·감정평가액·최저매각가격·진행상태를 조회합니다.","security":[{"bearerAuth":[]}],"parameters":[],"responses":{"200":{"description":"서비스별 성공·처리 상태 응답","content":{"application/json":{"schema":{"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 호출 공통 데이터"}}}}}},"default":{"description":"HTTP 상태 및 서비스 오류코드 확인","content":{"application/json":{"schema":{"type":"object"}}}}},"requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"type":"object","properties":{"case_no":{"type":"string","description":"사건번호 (예: 2024타경12345) — 연도·사건부호·번호 문자열로 보내며, 생략하면 서버 기본값이 적용되거나 해당 조건이 해제됩니다. (string)","example":"2025타경104697"},"court":{"type":"string","description":"법원 이름 또는 법원 코드 (예: 서울중앙지방법원) 문자열로 보내며, 생략하면 서버 기본값이 적용되거나 해당 조건이 해제됩니다. (string)","example":"서울중앙지방법원"}},"required":["case_no","court"]}}}}}}},"x-code-tables":[],"x-service-errors":[],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer"}}}}