Service
국토교통부 건축HUB의 표제부·기본개요·총괄표제부·층별개요·부속지번·전유공용면적·주택가격·전유부·오수정화시설·지역지구구역 정보를 조회합니다.
89.79%30일 가동률평균 응답670ms
행을 선택하면 해당 API의 레퍼런스로 이동합니다.
| Method | API | Path | Summary |
|---|---|---|---|
| POST | /v1/korea-building-register/get-building-area-district-zones | Gets official area, district, and zone (지역·지구·구역) designation records linked to a building register: zoning layer, designation code, name, whether it is the representative designation, and other designation text. Filters by district_code and neighborhood_code, optionally narrowed by lot number (main_lot_number/sub_lot_number) or a register update date range (updated_from/updated_to). Use when you need the land-use zoning designations recorded for a lot, including their designation codes. Do NOT use when you only need the representative region, district, and zone names alongside register identifiers — use korea-building-register:get-building-basis-outline instead. Returns records plus page, limit, total_count, and has_more. | |
| POST | /v1/korea-building-register/get-building-attached-lots | Gets official attached-lot (부속지번) records linked to a building register: attached register division and the attached lot's district code, legal-neighborhood code, main and sub lot numbers, and other address text. Filters by district_code and neighborhood_code, optionally narrowed by lot number (main_lot_number/sub_lot_number) or a register update date range (updated_from/updated_to). Use when a building spans more than one lot and you need the identifiers of the additional lots. Do NOT use to list the buildings on a lot — use korea-building-register:list-buildings-on-lot instead. Returns records plus page, limit, total_count, and has_more. | |
| POST | /v1/korea-building-register/get-building-basis-outline | Gets official building-register basic outline (기본개요) records: ledger identifiers, lot and road addresses, register division and kind, parent-ledger and building-system identifiers, and land-use region, district, and zone names. Filters by district_code and neighborhood_code, optionally narrowed by lot number (main_lot_number/sub_lot_number) or a register update date range (updated_from/updated_to). Use when you need the register's own identifiers (ledger_id, parent_ledger_id, building_system_id) or want to browse registers updated within a date range. Do NOT use for structure, floor counts, areas, or ratios — use korea-building-register:list-buildings-on-lot and then korea-building-register:get-building-detail instead. Do NOT use for zoning designation codes — use korea-building-register:get-building-area-district-zones instead. Returns records plus page, limit, total_count, and has_more. |
sandbox key를 발급받고 첫 예약 생성까지 진행합니다.
파트너 credential은 APIFuse이 보관합니다. 발급받는 것은 하나의 managed key입니다.
예약 확정, 배달 상태 변경 같은 이벤트를 webhook으로 수신합니다.
서비스 장애와 게이트웨이 에러를 하나의 에러 모델로 정규화합니다.
| POST | /v1/korea-building-register/get-building-detail | Returns the full 건축물대장 표제부 (title section) detail for one building identified by a building_id from list-buildings-on-lot: structure, main use, roof type, height, floor counts, total floor area, building coverage ratio (건폐율), floor area ratio (용적률), approval date, parking spaces, and elevator count. Use after korea-building-register:list-buildings-on-lot once you have a specific building_id. Do NOT use to discover the buildings on a lot — use korea-building-register:list-buildings-on-lot instead. Do NOT use for lot-level totals such as site area or household counts — use korea-building-register:get-building-recap-title instead. The lookup follows at most 50 upstream pages. Throws a not-found error (never an empty record) if the building_id no longer matches any ledger entry. Returns building_name, main_use, structure, roof_type, height_m, ground_floors, basement_floors, total_floor_area_sqm, building_coverage_ratio, floor_area_ratio, approved_on, parking_spaces, and elevator_count. |
| POST | /v1/korea-building-register/get-building-exclusive-common-areas | Gets official exclusive/common-area (전유공용면적) records for collective buildings by wing, unit, and floor: exclusive-versus-common classification, main-versus-attached classification, structure, use, and area in square meters. Filters by district_code and neighborhood_code, optionally narrowed by lot number (main_lot_number/sub_lot_number) or a register update date range (updated_from/updated_to). Use when you need the exclusive or shared area of specific units (호), such as apartment units. Do NOT use when you only need unit identifiers without areas — use korea-building-register:get-building-exclusive-sections instead. Do NOT use for per-floor totals of a whole building — use korea-building-register:get-building-floor-outline instead. Returns records plus page, limit, total_count, and has_more. |
| POST | /v1/korea-building-register/get-building-exclusive-sections | Gets official exclusive-section (전유부) records for collective buildings: the wing, unit, and floor identifiers of each unit together with its register identity fields. Filters by district_code and neighborhood_code, optionally narrowed by lot number (main_lot_number/sub_lot_number) or a register update date range (updated_from/updated_to). Use when you need to enumerate the units (호) of a collective building. Do NOT use when you need unit areas — use korea-building-register:get-building-exclusive-common-areas instead. Do NOT use for housing prices — use korea-building-register:get-building-housing-prices instead. Returns records plus page, limit, total_count, and has_more. |
| POST | /v1/korea-building-register/get-building-floor-outline | Gets official floor-by-floor outline (층별개요) records: wing name, floor division and number, floor label, structure, use, main-versus-attached classification, area in square meters, and whether the area is excluded from floor-area calculations. Filters by district_code and neighborhood_code, optionally narrowed by lot number (main_lot_number/sub_lot_number) or a register update date range (updated_from/updated_to). Use when you need the use or area of each floor of a building. Do NOT use for per-unit (호) areas in collective buildings — use korea-building-register:get-building-exclusive-common-areas instead. Do NOT use for whole-building totals — use korea-building-register:get-building-detail instead. Returns records plus page, limit, total_count, and has_more. |
| POST | /v1/korea-building-register/get-building-housing-prices | Gets official building-register housing price (주택가격) records: the recorded housing price in Korean won and its valuation standard date for each unit. Filters by district_code and neighborhood_code, optionally narrowed by lot number (main_lot_number/sub_lot_number) or a register update date range (updated_from/updated_to). Use when you need the officially recorded housing price of a unit and the date it applies to. Do NOT use for unit areas — use korea-building-register:get-building-exclusive-common-areas instead. Do NOT use for unit identifiers alone — use korea-building-register:get-building-exclusive-sections instead. Returns records plus page, limit, total_count, and has_more. |
| POST | /v1/korea-building-register/get-building-recap-title | Gets official recap-title (총괄표제부) records for a lot: site, building, and total floor area, coverage and floor-area ratios, main use, household and family counts, main and attached building counts, parking spaces, and approval date, aggregated across the buildings on the lot. Filters by district_code and neighborhood_code, optionally narrowed by lot number (main_lot_number/sub_lot_number) or a register update date range (updated_from/updated_to). Use when you need lot-level totals for a site with several buildings, such as an apartment complex. Do NOT use for one building's own title section — use korea-building-register:list-buildings-on-lot and then korea-building-register:get-building-detail instead. Returns records plus page, limit, total_count, and has_more. |
| POST | /v1/korea-building-register/get-building-sewage-treatment-facilities | Gets official sewage-treatment facility (오수정화시설) records: treatment mode, capacity unit, and capacity by people and by volume. Filters by district_code and neighborhood_code, optionally narrowed by lot number (main_lot_number/sub_lot_number) or a register update date range (updated_from/updated_to). Use when you need the sewage-treatment facility recorded for a building. Do NOT use for general building facts such as structure or floor area — use korea-building-register:get-building-detail instead. Returns records plus page, limit, total_count, and has_more. |
| POST | /v1/korea-building-register/list-buildings-on-lot | Lists one page of buildings registered on an administrative lot (title-section rows of the 건축물대장) identified by district_code, neighborhood_code, main_lot_number, and sub_lot_number. Use when you have a lot address and need to find its buildings or obtain a building_id. Do NOT use for one building's full title-section details — use korea-building-register:get-building-detail with a returned building_id instead. Do NOT use for lot-level totals or to browse registers changed in a date range — use korea-building-register:get-building-recap-title or korea-building-register:get-building-basis-outline instead. Defaults to 20 and allows at most 100 rows per call. Returned building_id values are authenticated, encrypted selection tokens for get-building-detail. Returns buildings, total_count, page, limit, and has_more. |
