Service
건강보험심사평가원(HIRA)이 data.go.kr에 제공하는 병원정보서비스를 통해 국내 의료기관(병원, 의원)을 조회합니다. 이름으로 검색하거나 시·도별 목록을 조회할 수 있으며, 종별·위치·연락처 필드를 포함합니다.
96.66%30일 가동률평균 응답2883ms
행을 선택하면 해당 API의 레퍼런스로 이동합니다.
| Method | API | Path | Summary |
|---|---|---|---|
| POST | /v1/korea-hospital-info/hospital-locations | Lists one caller-selected page of at most 100 medical institutions within a given province or metropolitan city (province, e.g. 서울, 부산); an optional facility-type filter (hospital_type) is applied only within that page. Use when exploring the hospitals of a region without a specific hospital name in mind. Do NOT use when you already know the hospital's name — use korea-hospital-info:search-hospitals-by-name instead. Requires province; unrecognized province names are rejected. Returns items (facility_code, hospital_name, hospital_type, province_name, address, telno, phone_e164, longitude, latitude), page, limit, total_count and has_more (both null when hospital_type is applied, because both describe the unfiltered upstream result set). Published as list-hospital-locations before 2026-09-12; that id no longer resolves. The deprecated input names sido_cd_nm and cl_cd_nm still work until 2026-10-12. | |
| POST | /v1/korea-hospital-info/search-hospitals-by-name | Searches HIRA's hospital registry by full or partial hospital name (query) and returns one caller-selected page of at most 100 records; the optional province filter narrows the upstream query itself, while an optional facility-type (hospital_type) filter is applied only within the returned page. Use when you know all or part of the hospital's name. Do NOT use for browsing every hospital in a province — use korea-hospital-info:hospital-locations instead. Use page/limit to continue to the next page. Returns items (facility_code, hospital_name, hospital_type, province_name, address, telno, phone_e164, longitude, latitude), returned_count, page, limit, total_count and has_more (both null when hospital_type or province is applied, because both describe the unfiltered upstream result set). The deprecated input names yadm_nm, cl_cd_nm and sido_cd_nm are still accepted until 2026-10-12; sending one together with its replacement is rejected. |
sandbox key를 발급받고 첫 예약 생성까지 진행합니다.
파트너 credential은 APIFuse이 보관합니다. 발급받는 것은 하나의 managed key입니다.
예약 확정, 배달 상태 변경 같은 이벤트를 webhook으로 수신합니다.
서비스 장애와 게이트웨이 에러를 하나의 에러 모델로 정규화합니다.
지난 30일 동안 이 서비스에서 관측된 기록입니다.
