Service
E-Gen 응급의료 공공데이터를 통해 전국 응급의료기관, 외상센터, 실시간 병상 현황, 중증질환 수용 정보, 응급 메시지를 조회합니다.
100.00%30일 가동률평균 응답515ms
행을 선택하면 해당 API의 레퍼런스로 이동합니다.
| Method | API | Path | Summary |
|---|---|---|---|
| POST | /v1/korea-emergency-hospital/emergency-beds-by-region | Returns a paginated list of hospitals in one province (sido) and district (sigungu) with only the core live emergency bed fields: emergency room bed count, emergency phone, and update time. Use when browsing a region page by page or when only the ER bed count is needed. Do NOT use when ICU bed counts or equipment availability are needed — use korea-emergency-hospital:search-real-time-emergency-beds instead. Both sido and sigungu are required. Returns hospitals[] with hospital_id, hospital_name, emergency_phone_e164, emergency_beds_available, and updated_at, plus total_count, page, and limit. The deprecated national-format emergency_phone field is still emitted until 2026-10-12. | |
| POST | /v1/korea-emergency-hospital/emergency-hospital | Returns the full directory profile of one emergency hospital identified by hospital_id, including postal code, fax, homepage, per-day treatment hours, description, and notes. Use when the user needs details of a hospital already found by a search operation. Do NOT use for live bed counts — use korea-emergency-hospital:search-real-time-emergency-beds instead; do NOT use for hospital notices — use korea-emergency-hospital:emergency-messages instead; do NOT use for trauma centers — use korea-emergency-hospital:trauma-center instead. Fails with NO_DATA when the hospital_id is unknown. Returns a single hospital object with hospital_id, hospital_name, address, phone_e164, emergency_phone_e164, latitude, longitude, postal_code, fax_e164, homepage, treatment_hours[], description, and notes. The deprecated national-format phone, emergency_phone and fax fields are still emitted until 2026-10-12. | |
| POST | /v1/korea-emergency-hospital/emergency-messages | Returns the emergency room and serious-disease notice messages that one hospital, identified by hospital_id, has published. Use when the user asks about a specific hospital's current ER notices, restrictions, or block periods. Do NOT use for region-wide acceptance status — use korea-emergency-hospital:search-serious-disease-acceptance instead; do NOT use for bed counts — use korea-emergency-hospital:search-real-time-emergency-beds instead. Fails with NO_DATA when the hospital_id is unknown; an empty messages[] means the hospital has no current messages. Returns messages[] with message, message_type, message_type_code, message_type_name, display_method, display_status, block_start_at, and block_end_at, plus total_count, page, and limit. |
sandbox key를 발급받고 첫 예약 생성까지 진행합니다.
파트너 credential은 APIFuse이 보관합니다. 발급받는 것은 하나의 managed key입니다.
예약 확정, 배달 상태 변경 같은 이벤트를 webhook으로 수신합니다.
서비스 장애와 게이트웨이 에러를 하나의 에러 모델로 정규화합니다.
| POST | /v1/korea-emergency-hospital/search-emergency-hospitals | Returns directory entries for emergency medical institutions filtered by province, district, a free-text query matched against the hospital name, institution class, disease code, or treatment day, ordered by sort_by (name or address). Use when looking up which emergency hospitals exist in an area or finding a hospital_id by name. Do NOT use for live bed counts — use korea-emergency-hospital:search-real-time-emergency-beds instead; do NOT use for coordinate-based search — use korea-emergency-hospital:search-emergency-hospitals-nearby instead; do NOT use for trauma centers — use korea-emergency-hospital:search-trauma-centers instead. province is required when district is given. Returns hospitals[] with hospital_id, hospital_name, address, phone_e164, emergency_phone_e164, latitude, and longitude, plus total_count, page, and limit. The deprecated national-format phone and emergency_phone fields are still emitted until 2026-10-12. |
| POST | /v1/korea-emergency-hospital/search-emergency-hospitals-nearby | Returns emergency hospitals within radius_meters of a WGS84 latitude and longitude, with the distance to each. Use when the user gives a location or coordinates rather than a region name. Do NOT use for region- or name-based search — use korea-emergency-hospital:search-emergency-hospitals instead; do NOT use for trauma centers — use korea-emergency-hospital:search-trauma-centers-nearby instead. radius_meters accepts 100-20000 (default 3000); rows the upstream reports outside the radius are dropped, so a page can hold fewer than limit rows. Returns hospitals[] with distance_meters, institution_division_code, institution_division_name, and contact fields, plus total_count, page, and limit. |
| POST | /v1/korea-emergency-hospital/search-real-time-emergency-beds | Returns live emergency room bed counts, ICU and ward bed counts, equipment availability flags, and on-call contact details for hospitals in one province (sido) and district (sigungu). Use when the user asks which emergency rooms currently have beds or specific equipment such as CT, MRI, ventilators, or ECMO. Do NOT use when only the ER bed count and emergency phone are needed — use korea-emergency-hospital:emergency-beds-by-region instead for smaller rows; do NOT use for coordinate-based search — use korea-emergency-hospital:search-emergency-hospitals-nearby instead. Both sido and sigungu are required. Returns hospitals[] with hospital_id, emergency_beds_available, per-unit bed counts, *_available flags, and updated_at, plus total_count, page, and limit. |
| POST | /v1/korea-emergency-hospital/search-serious-disease-acceptance | Returns, for hospitals in one province (sido) and district (sigungu), whether each of the 28 serious-disease treatment types (for example reperfusion for myocardial infarction, cerebral hemorrhage surgery, emergency dialysis) can currently be accepted, with optional notes. Use when the user asks which hospitals can take a specific serious condition right now. Do NOT use for general ER bed counts — use korea-emergency-hospital:search-real-time-emergency-beds instead; do NOT use for a single hospital's published notices — use korea-emergency-hospital:emergency-messages instead. disease_type selects the upstream acceptance type (1-3, default 1). Returns hospitals[] with hospital_id, hospital_name, and acceptances[] (disease_type_index, disease_code, disease_name, status, note), plus total_count, page, and limit. |
| POST | /v1/korea-emergency-hospital/search-trauma-centers | Returns trauma center directory entries, optionally filtered by province and district and ordered by sort_by (name or address). Use when the user asks for trauma centers in a region or needs a trauma center hospital_id. Do NOT use for general emergency hospitals — use korea-emergency-hospital:search-emergency-hospitals instead; do NOT use for coordinate-based search — use korea-emergency-hospital:search-trauma-centers-nearby instead. province is required when district is given. Returns trauma_centers[] with hospital_id, hospital_name, address, phone_e164, emergency_phone_e164, institution_class_code, institution_class_name, latitude, and longitude, plus total_count, page, and limit. The deprecated national-format phone and emergency_phone fields are still emitted until 2026-10-12. |
| POST | /v1/korea-emergency-hospital/search-trauma-centers-nearby | Returns trauma centers within radius_meters of a WGS84 latitude and longitude, with the distance to each. Use when the user gives a location or coordinates rather than a region name. Do NOT use for region-based search — use korea-emergency-hospital:search-trauma-centers instead; do NOT use for general emergency hospitals — use korea-emergency-hospital:search-emergency-hospitals-nearby instead. radius_meters accepts 100-20000 (default 3000); rows the upstream reports outside the radius are dropped, so a page can hold fewer than limit rows. Returns trauma_centers[] with distance_meters, institution_division_code, institution_division_name, and contact fields, plus total_count, page, and limit. |
| POST | /v1/korea-emergency-hospital/trauma-center | Returns the directory profile of one trauma center identified by hospital_id. Use when the user needs the address, phone numbers, or coordinates of a trauma center already found by a trauma center search. Do NOT use for general emergency hospitals — use korea-emergency-hospital:emergency-hospital instead; do NOT use for live bed counts — use korea-emergency-hospital:search-real-time-emergency-beds instead. Institution class fields are not returned here; take them from korea-emergency-hospital:search-trauma-centers. Fails with NO_DATA when the hospital_id is unknown. Returns a single object with hospital_id, hospital_name, address, phone_e164, emergency_phone_e164, latitude, and longitude. The deprecated national-format phone and emergency_phone fields are still emitted until 2026-10-12. |
