APIFuseAPIFuse
DocsServicesPlaygroundStatus
Log inSign up

Service

Korea Hospital Info

Korea, HealthAvailable
Try in PlaygroundOpen the API reference

Overview

Looks up South Korean medical institutions (hospitals, clinics) via the Health Insurance Review & Assessment Service (HIRA / 건강보험심사평가원) hospital information service on data.go.kr — search by name or list by province, with type, location, and contact fields.

Status

Operational

97.47%30-day uptimeAvg response2537ms

2026-09-192026-10-042026-10-18

Setup

Auth mode
Managed key
Credentials
  • A managed key scoped to korea-hospital-info
Sandbox
Not available

APIs

Selecting a row opens the reference for that API.

MethodAPIPathSummary
POST/v1/korea-hospital-info/hospital-locationsLists 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-nameSearches 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.

Related guides

  • Issue a sandbox key and make your first reservation.

  • APIFuse holds the partner credentials. You hold one managed key.

  • Receive events such as reservation confirmations and delivery updates.

  • Service outages and gateway errors normalise into one error model.

Hospital locations
Search hospitals by name
Quickstart
Managed keys
Overview
Error model