{"openapi":"3.0.3","info":{"title":"APICK 건축물대장 조회","version":"1.0.0","description":"필지고유번호(PNU) 또는 시군구·법정동·번지로 건축물대장을 조회합니다. 표제부·총괄표제부·기본개요·층별개요·전유부·전유공용면적·주택가격·오수정화시설·부속지번·지역지구구역 10종을 같은 주소로 조회할 수 있습니다."},"servers":[{"url":"https://apick.app"}],"paths":{"/rest/bldrgst":{"post":{"summary":"건축물대장 조회","description":"필지고유번호(PNU) 또는 시군구·법정동·번지로 건축물대장을 조회합니다. 표제부·총괄표제부·기본개요·층별개요·전유부·전유공용면적·주택가격·오수정화시설·부속지번·지역지구구역 10종을 같은 주소로 조회할 수 있습니다.","security":[{"bearerAuth":[]}],"parameters":[],"responses":{"200":{"description":"서비스별 성공·처리 상태 응답","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"type":{"type":"string","description":"조회한 대장 종류입니다."},"params":{"type":"object","properties":{"sigunguCd":{"type":"string"},"bjdongCd":{"type":"string"},"platGbCd":{"type":"string"},"bun":{"type":"string"},"ji":{"type":"string"},"hoNm":{"type":"string"},"numOfRows":{"type":"integer"},"pageNo":{"type":"integer"}},"description":"실제로 적용된 조회 조건입니다. 보낸 값이 정규화된 결과를 확인할 때 씁니다."},"items":{"type":"array","items":{"type":"object","properties":{"platPlc":{"type":"string","description":"지번 주소입니다."},"newPlatPlc":{"type":"string","description":"도로명 주소입니다."},"bldNm":{"type":"string","description":"건물 이름입니다."},"dongNm":{"type":"string","description":"동 이름입니다."},"hoNm":{"type":"string","description":"호 이름입니다."},"flrNo":{"type":"integer","description":"층 번호입니다."},"flrNoNm":{"type":"string"},"exposPubuseGbCdNm":{"type":"string"},"mainPurpsCdNm":{"type":"string","description":"주용도 이름입니다."},"strctCdNm":{"type":"string","description":"구조 이름입니다."},"area":{"type":"number","description":"면적(㎡)입니다. 전유공용면적·층별개요에서 씁니다."},"crtnDay":{"type":"string","description":"대장 생성일입니다. startDate·endDate는 이 값을 기준으로 거릅니다."},"platArea":{"type":"number","description":"대지면적(㎡)입니다."},"archArea":{"type":"number","description":"건축면적(㎡)입니다."},"totArea":{"type":"number","description":"연면적(㎡)입니다."},"useAprDay":{"type":"string","description":"사용승인일입니다. YYYYMMDD 형식입니다."}}},"description":"대장 항목 목록입니다. totalCount가 0이면 빈 배열입니다."},"count":{"type":"integer","description":"이번 응답에 담긴 건수입니다."},"totalCount":{"type":"integer","description":"조건에 맞는 전체 건수입니다."},"pageNo":{"type":"integer","description":"이번 쪽 번호입니다."},"numOfRows":{"type":"integer","description":"한 쪽에 요청한 건수입니다."}}},"api":{"type":"object","properties":{"cost":{"type":"integer","description":"차감된 포인트입니다. 실패한 응답은 0입니다."},"success":{"type":"boolean","description":"서버가 응답을 만들었는지 여부입니다."},"ms":{"type":"integer","description":"처리 시간(밀리초)입니다."}}}}}}}},"default":{"description":"HTTP 상태 및 서비스 오류코드 확인","content":{"application/json":{"schema":{"type":"object"}}}}},"requestBody":{"required":false,"content":{"multipart/form-data":{"schema":{"type":"object","properties":{"pnu":{"type":"string","description":"필지고유번호 19자리. 주면 번지 항목은 무시합니다. 문자열로 보내며, 생략하면 서버 기본값이 적용되거나 해당 조건이 해제됩니다. (string)","example":"1168010100108250000"},"sigunguCd":{"type":"string","description":"시군구코드 5자리 (pnu 가 없을 때) 문자열로 보내며, 생략하면 서버 기본값이 적용되거나 해당 조건이 해제됩니다. (string)"},"bjdongCd":{"type":"string","description":"법정동코드 5자리 (pnu 가 없을 때) 문자열로 보내며, 생략하면 서버 기본값이 적용되거나 해당 조건이 해제됩니다. (string)"},"platGbCd":{"type":"string","description":"0 대지(기본), 1 산. 대지·산·임야 표기도 받습니다. 문자열로 보내며, 생략하면 서버 기본값이 적용되거나 해당 조건이 해제됩니다. 가능한 값은 2가지입니다. 0 = 0 값을 뜻하며, 같은 응답의 다른 필드와 함께 해석하세요. 1 = 1 값을 뜻하며, 같은 응답의 다른 필드와 함께 해석하세요. (string)","enum":["0","1"]},"bun":{"type":"string","description":"본번. 숫자만 보내면 4자리로 채웁니다. 문자열로 보내며, 생략하면 서버 기본값이 적용되거나 해당 조건이 해제됩니다. (string)"},"ji":{"type":"string","description":"부번 (기본 0000) 문자열로 보내며, 생략하면 서버 기본값이 적용되거나 해당 조건이 해제됩니다. (string)"},"type":{"type":"string","description":"대장 종류 (기본 title) 문자열로 보내며, 생략하면 서버 기본값이 적용되거나 해당 조건이 해제됩니다. 가능한 값은 10가지입니다. title = title 값을 뜻하며, 같은 응답의 다른 필드와 함께 해석하세요. recap = recap 값을 뜻하며, 같은 응답의 다른 필드와 함께 해석하세요. basis = basis 값을 뜻하며, 같은 응답의 다른 필드와 함께 해석하세요. floor = floor 값을 뜻하며, 같은 응답의 다른 필드와 함께 해석하세요. expos = expos 값을 뜻하며, 같은 응답의 다른 필드와 함께 해석하세요. area = area 값을 뜻하며, 같은 응답의 다른 필드와 함께 해석하세요. price = price 값을 뜻하며, 같은 응답의 다른 필드와 함께 해석하세요. wclf = wclf 값을 뜻하며, 같은 응답의 다른 필드와 함께 해석하세요. jibun = jibun 값을 뜻하며, 같은 응답의 다른 필드와 함께 해석하세요. district = district 값을 뜻하며, 같은 응답의 다른 필드와 함께 해석하세요. (string)","enum":["title","recap","basis","floor","expos","area","price","wclf","jibun","district"],"example":"area"},"startDate":{"type":"string","description":"대장 생성일 범위 시작. title·recap 전용. 2024 / 2024-06 / 20240101 (string)"},"endDate":{"type":"string","description":"대장 생성일 범위 끝. title·recap 전용. 연·월만 보내면 그 달 마지막 날로 맞춥니다. (string)"},"dongNm":{"type":"string","description":"동 이름. floor·expos·area·price 전용 문자열로 보내며, 생략하면 서버 기본값이 적용되거나 해당 조건이 해제됩니다. (string)"},"hoNm":{"type":"string","description":"호 이름. floor·expos·area·price 전용 문자열로 보내며, 생략하면 서버 기본값이 적용되거나 해당 조건이 해제됩니다. (string)","example":"2101호"},"flrNo":{"type":"string","description":"층 번호. area 전용. 지하는 음수 숫자로 보내며, 허용 범위를 벗어나면 요청이 거부됩니다. (integer)"},"pageNo":{"type":"string","description":"쪽 번호 (기본 1) 숫자로 보내며, 허용 범위를 벗어나면 요청이 거부됩니다. (integer)"},"numOfRows":{"type":"string","description":"한 쪽 건수 (기본 20, 최대 100) 숫자로 보내며, 허용 범위를 벗어나면 요청이 거부됩니다. (integer)","example":"20"}}}}}}}}},"x-code-tables":[{"title":"type 허용값","columns":["값","조회 내용"],"rows":[["title","표제부 — 건물 한 건의 개요·면적·구조·용도·층수·주차·승강기 (기본값)"],["recap","총괄표제부 — 단지 전체를 묶은 표제부"],["basis","기본개요 — 대장 기재 사항의 기본 정보"],["floor","층별개요 — 층마다의 구조·용도·면적"],["expos","전유부 — 동·호별 전유 부분"],["area","전유공용면적 — 전유·공용 면적 배분"],["price","주택가격 — 공동주택 가격 공시 정보"],["wclf","오수정화시설 — 정화조 용량·형식"],["jibun","부속지번 — 건물에 딸린 다른 필지"],["district","지역지구구역 — 대지가 속한 지역·지구·구역"]]}],"x-service-errors":[],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer"}}}}