Skip to content

건강보험심사평가원 원본

건강보험심사평가원(HIRA) 등록 병원 API입니다. 병원 목록 조회와 요양기관기호(ykiho) 기반 상세 조회를 제공합니다.

접근 권한 안내

이 데이터는 정부데이터 원본(공공데이터포털)을 캐싱한 자료입니다. 현재는 공개되어 있으나, 추후 허가받은 사용자만 접근할 수 있도록 제한될 예정입니다.

특징

  • 공공데이터포털의 데이터를 빠르게 접근할 수 있습니다.
  • 필터 조건을 세분화하고 검색 성능을 개선했습니다.

데이터 출처

  • 건강보험심사평가원(HIRA)에 등록된 정보입니다. — https://www.hira.or.kr
  • 대한민국 공공데이터포털에서 제공한 원본 데이터를 캐싱하여 제공합니다.
  • 원본 데이터포털과 하루 한 번 재동기화됩니다.

데이터 정확성

데이터가 잘못된 경우, 원본 제공처(건강보험심사평가원 또는 공공데이터포털)의 원본 데이터 오류일 수 있습니다.

TIP

값이 없는(null) 필드는 응답에서 생략됩니다.

병원 목록 조회

GET
/data-go-kr/hira/hospitals

로컬 DB 에 미러링한 HIRA 병원 목록. 응답 구조는 원본 API 와 동일하다.

Request

🔒 Bearer 인증 필요 · 인증 방법
GET/data-go-kr/hira/hospitals

Query Parameters

NameTypeRequiredConstraintsDescription
pagenumberoptionaldefault 1페이지 번호
sizenumberoptionalmin 1 · max 100 · default 20페이지 크기

Response

200

HiraHospitalListResponse

FieldTypeRequiredConstraintsDescription
responseHiraHospitalListResultoptional

HiraHospitalListResult

FieldTypeRequiredConstraintsDescription
headerHiraResultHeaderoptional
resultCodestringoptional결과코드 (정상: 00)
resultMsgstringoptional결과메시지
bodyHiraHospitalListBodyoptional
numOfRowsintegeroptional한 페이지 결과 수
pageNointegeroptional현재 페이지 번호
totalCountintegeroptional전체 결과 수
itemsHiraHospitalListItemsoptional
itemHiraHospitalItem[]optional
ykihostringoptional암호화된 요양기호. 상세정보 조회(MadmDtlInfoService2.8)의 키다.
yadmNmstringoptional병원명
clCdstringoptional종별코드
clCdNmstringoptional종별코드명 (예: 상급종합)
sidoCdstringoptional시도코드
sidoCdNmstringoptional시도명
sgguCdstringoptional시군구코드
sgguCdNmstringoptional시군구명
emdongNmstringoptional읍면동명
postNostringoptional우편번호
addrstringoptional주소
telnostringoptional전화번호
hospUrlstringoptional홈페이지
estbDdstringoptional개설일자 (YYYYMMDD)
drTotCntintegeroptional의사총수
mdeptGdrCntintegeroptional의과일반의 인원수
mdeptIntnCntintegeroptional의과인턴 인원수
mdeptResdntCntintegeroptional의과레지던트 인원수
mdeptSdrCntintegeroptional의과전문의 인원수
detyGdrCntintegeroptional치과일반의 인원수
detyIntnCntintegeroptional치과인턴 인원수
detyResdntCntintegeroptional치과레지던트 인원수
detySdrCntintegeroptional치과전문의 인원수
cmdcGdrCntintegeroptional한방일반의 인원수
cmdcIntnCntintegeroptional한방인턴 인원수
cmdcResdntCntintegeroptional한방레지던트 인원수
cmdcSdrCntintegeroptional한방전문의 인원수
pnursCntintegeroptional공식 가이드(2021)에 없는 필드. 값이 대부분 0 이고 드물게 한 자릿수인 것으로 보아 전문간호사 수로 추정된다.
XPosstringoptionalx좌표 (경도). 대문자 X 로 시작한다.
YPosstringoptionaly좌표 (위도). 대문자 Y 로 시작한다.
distancestringoptional거리(m). xPos/yPos/radius 로 반경 검색했을 때만 온다.
{
  "response": {
    "header": {
      "resultCode": "string",
      "resultMsg": "string"
    },
    "body": {
      "numOfRows": 0,
      "pageNo": 0,
      "totalCount": 0,
      "items": {
        "item": [
          {
            "ykiho": "string",
            "yadmNm": "string",
            "clCd": "string",
            "clCdNm": "string",
            "sidoCd": "string",
            "sidoCdNm": "string",
            "sgguCd": "string",
            "sgguCdNm": "string",
            "emdongNm": "string",
            "postNo": "string",
            "addr": "string",
            "telno": "string",
            "hospUrl": "string",
            "estbDd": "string",
            "drTotCnt": 0,
            "mdeptGdrCnt": 0,
            "mdeptIntnCnt": 0,
            "mdeptResdntCnt": 0,
            "mdeptSdrCnt": 0,
            "detyGdrCnt": 0,
            "detyIntnCnt": 0,
            "detyResdntCnt": 0,
            "detySdrCnt": 0,
            "cmdcGdrCnt": 0,
            "cmdcIntnCnt": 0,
            "cmdcResdntCnt": 0,
            "cmdcSdrCnt": 0,
            "pnursCnt": 0,
            "XPos": "string",
            "YPos": "string",
            "distance": "string"
          }
        ]
      }
    }
  }
}

Playground

Server
Authorization
Variables
Key
Value

Samples

Powered by VitePress OpenAPI

병원 상세 조회

GET
/data-go-kr/hira/hospitals/{ykiho}

암호화된 요양기호로 1건 조회. 없으면 items 가 빈 배열이고 totalCount 가 0 이다.

Request

🔒 Bearer 인증 필요 · 인증 방법
GET/data-go-kr/hira/hospitals/{ykiho}

Path Parameters

NameTypeRequiredConstraintsDescription
ykihostringrequired암호화된 요양기호. 목록 응답의 ykiho 를 그대로 쓴다.

Response

200

HiraHospitalListResponse

FieldTypeRequiredConstraintsDescription
responseHiraHospitalListResultoptional

HiraHospitalListResult

FieldTypeRequiredConstraintsDescription
headerHiraResultHeaderoptional
resultCodestringoptional결과코드 (정상: 00)
resultMsgstringoptional결과메시지
bodyHiraHospitalListBodyoptional
numOfRowsintegeroptional한 페이지 결과 수
pageNointegeroptional현재 페이지 번호
totalCountintegeroptional전체 결과 수
itemsHiraHospitalListItemsoptional
itemHiraHospitalItem[]optional
ykihostringoptional암호화된 요양기호. 상세정보 조회(MadmDtlInfoService2.8)의 키다.
yadmNmstringoptional병원명
clCdstringoptional종별코드
clCdNmstringoptional종별코드명 (예: 상급종합)
sidoCdstringoptional시도코드
sidoCdNmstringoptional시도명
sgguCdstringoptional시군구코드
sgguCdNmstringoptional시군구명
emdongNmstringoptional읍면동명
postNostringoptional우편번호
addrstringoptional주소
telnostringoptional전화번호
hospUrlstringoptional홈페이지
estbDdstringoptional개설일자 (YYYYMMDD)
drTotCntintegeroptional의사총수
mdeptGdrCntintegeroptional의과일반의 인원수
mdeptIntnCntintegeroptional의과인턴 인원수
mdeptResdntCntintegeroptional의과레지던트 인원수
mdeptSdrCntintegeroptional의과전문의 인원수
detyGdrCntintegeroptional치과일반의 인원수
detyIntnCntintegeroptional치과인턴 인원수
detyResdntCntintegeroptional치과레지던트 인원수
detySdrCntintegeroptional치과전문의 인원수
cmdcGdrCntintegeroptional한방일반의 인원수
cmdcIntnCntintegeroptional한방인턴 인원수
cmdcResdntCntintegeroptional한방레지던트 인원수
cmdcSdrCntintegeroptional한방전문의 인원수
pnursCntintegeroptional공식 가이드(2021)에 없는 필드. 값이 대부분 0 이고 드물게 한 자릿수인 것으로 보아 전문간호사 수로 추정된다.
XPosstringoptionalx좌표 (경도). 대문자 X 로 시작한다.
YPosstringoptionaly좌표 (위도). 대문자 Y 로 시작한다.
distancestringoptional거리(m). xPos/yPos/radius 로 반경 검색했을 때만 온다.
{
  "response": {
    "header": {
      "resultCode": "string",
      "resultMsg": "string"
    },
    "body": {
      "numOfRows": 0,
      "pageNo": 0,
      "totalCount": 0,
      "items": {
        "item": [
          {
            "ykiho": "string",
            "yadmNm": "string",
            "clCd": "string",
            "clCdNm": "string",
            "sidoCd": "string",
            "sidoCdNm": "string",
            "sgguCd": "string",
            "sgguCdNm": "string",
            "emdongNm": "string",
            "postNo": "string",
            "addr": "string",
            "telno": "string",
            "hospUrl": "string",
            "estbDd": "string",
            "drTotCnt": 0,
            "mdeptGdrCnt": 0,
            "mdeptIntnCnt": 0,
            "mdeptResdntCnt": 0,
            "mdeptSdrCnt": 0,
            "detyGdrCnt": 0,
            "detyIntnCnt": 0,
            "detyResdntCnt": 0,
            "detySdrCnt": 0,
            "cmdcGdrCnt": 0,
            "cmdcIntnCnt": 0,
            "cmdcResdntCnt": 0,
            "cmdcSdrCnt": 0,
            "pnursCnt": 0,
            "XPos": "string",
            "YPos": "string",
            "distance": "string"
          }
        ]
      }
    }
  }
}

Playground

Server
Authorization
Variables
Key
Value

Samples

Powered by VitePress OpenAPI

비급여 진료비 조회

GET
/data-go-kr/hira/hospitals/{ykiho}/npay

기관이 신고한 비급여 항목별 실제 청구금액(curAmt). 응답 구조는 원본 API 와 동일하다.

병원급 이상만 있다 — 의원(clCd=31)은 원본에 통째로 없어 늘 빈 배열이다. 한 기관에 수백 행이다(최다 1,048건) — 페이지로 받아라.

Request

🔒 Bearer 인증 필요 · 인증 방법
GET/data-go-kr/hira/hospitals/{ykiho}/npay

Path Parameters

NameTypeRequiredConstraintsDescription
ykihostringrequired암호화된 요양기호. 통합 병원 상세(/healthcare/hospitals/:id)의 ykiho 를 그대로 쓴다.

Query Parameters

NameTypeRequiredConstraintsDescription
pagenumberoptionaldefault 1페이지 번호
sizenumberoptionalmin 1 · max 100 · default 20페이지 크기

Response

200

HiraNonPaymentDetailResponse

FieldTypeRequiredConstraintsDescription
responseHiraNonPaymentDetailResultoptional

HiraNonPaymentDetailResult

FieldTypeRequiredConstraintsDescription
headerHiraResultHeaderoptional
resultCodestringoptional결과코드 (정상: 00)
resultMsgstringoptional결과메시지
bodyHiraNonPaymentDetailBodyoptional
numOfRowsintegeroptional한 페이지 결과 수
pageNointegeroptional현재 페이지 번호
totalCountintegeroptional전체 결과 수
itemsHiraNonPaymentDetailItemsoptional
itemHiraNonPaymentDetailItem[]optional
ykihostringoptional암호화된 요양기호
yadmNmstringoptional병원명
clCdHiraClassCodeoptional
clCdNmstringoptional종별코드명 (예: 종합병원)
sidoCdintegeroptional시도코드
sidoCdNmstringoptional시도명 (예: 서울)
sgguCdintegeroptional시군구코드
sgguCdNmstringoptional시군구명 (예: 영등포구)
urlAddrstringoptional병원 비급여 안내 URL. **없는 행이 있다**(표본 4,000행 중 391건).
snointegeroptional일련번호
npayCdHiraNonPaymentCodeoptional
npayKorNmstringoptional비급여 한글명. '대분류/중분류/소분류' 를 슬래시로 이어 붙인 형태다 (예: MRI진단료/근골격계/고관절).
yadmNpayCdNmstringoptional요양기관이 자체적으로 붙인 항목명 (예: 'Hip MRI', 'MegaDerm 3~4mm*1*1Cm (엘앤씨바이오)'). **표기가 기관 제각각**이라 이 값으로 기관 간 비교에 쓰지 않는다 — 비교는 `npayCd` 로 한다.
adtFrDdHiraApplyDateoptional적용개시일자 (YYYYMMDD, JSON number)
adtEndDdHiraApplyDateoptional적용종료일자 (YYYYMMDD, JSON number). **종료가 없으면 `99991231`** 이다 — 현재 유효한 가격이라는 뜻이지 실제 날짜가 아니다.
curAmtintegeroptional현재금액 (단위: 원). 그 기관이 실제로 받는 금액이다.
{
  "response": {
    "header": {
      "resultCode": "string",
      "resultMsg": "string"
    },
    "body": {
      "numOfRows": 0,
      "pageNo": 0,
      "totalCount": 0,
      "items": {
        "item": [
          {
            "ykiho": "string",
            "yadmNm": "string",
            "clCd": "01",
            "clCdNm": "string",
            "sidoCd": 110000,
            "sidoCdNm": "string",
            "sgguCd": 110013,
            "sgguCdNm": "string",
            "urlAddr": "string",
            "sno": 0,
            "npayCd": "ABZ010001",
            "npayKorNm": "string",
            "yadmNpayCdNm": "string",
            "adtFrDd": {},
            "adtEndDd": {},
            "curAmt": 739000
          }
        ]
      }
    }
  }
}

Playground

Server
Authorization
Variables
Key
Value

Samples

Powered by VitePress OpenAPI

병원평가 등급 조회

GET
/data-go-kr/hira/hospitals/{ykiho}/asm

기관이 받은 평가항목별 등급. 응답 구조는 원본 API 와 동일하다.

한 기관에 1건이다 — 평가항목이 item 에 asmGrd01~24 로 가로로 붙는다(02·11 은 원본에 없다). 항목 번호의 이름은 /data-go-kr/hira/codes 가 아니라 통합 병원 상세가 붙여준다.

평가대상이 아니면 items 가 빈 배열이다 — 평가대상은 36,599곳으로 병원 전체의 부분집합이다. 대부분 의원(clCd=31)이라 병원급 전용은 아니다.

등급 값은 원본 그대로다. 정수 1~5 와 문자열 등급제외(평가는 했으나 등급 미부여)가 섞여 온다. 키 자체가 없으면 평가대상 제외라는 뜻이라 등급제외 와 다르다 — 합치면 정보가 사라진다. 천식(asmGrd16)만 인코딩이 달라 1 대신 양호, 등급제외 대신 0 을 쓴다. 0 은 최하가 아니라 등급제외다.

Request

🔒 Bearer 인증 필요 · 인증 방법
GET/data-go-kr/hira/hospitals/{ykiho}/asm

Path Parameters

NameTypeRequiredConstraintsDescription
ykihostringrequired암호화된 요양기호. 통합 병원 상세(/healthcare/hospitals/:id)의 ykiho 를 그대로 쓴다.

Response

200

HiraHospitalAssessmentResponse

FieldTypeRequiredConstraintsDescription
responseHiraHospitalAssessmentResultoptional

HiraHospitalAssessmentResult

FieldTypeRequiredConstraintsDescription
headerHiraResultHeaderoptional
resultCodestringoptional결과코드 (정상: 00)
resultMsgstringoptional결과메시지
bodyHiraHospitalAssessmentBodyoptional
numOfRowsintegeroptional한 페이지 결과 수
pageNointegeroptional현재 페이지 번호
totalCountintegeroptional전체 결과 수
itemsHiraHospitalAssessmentItemsoptional
itemHiraHospitalAssessmentItem[]optional
ykihostringoptional암호화된 요양기호
yadmNmstringoptional요양기관명
clCdobjectoptional종별코드. **숫자와 문자열이 섞여 온다.** '01'(상급종합)만 문자열이고 나머지(11·21·28·29·31·71·72·75…)는 정수다 — 앞자리 0 이 있는 코드만 문자열로 남기 때문이다. 비교할 때는 문자열로 맞춘다.
clCdNmstringoptional종별코드명
addrstringoptional주소
asmGrd01HiraAssessmentGradeoptional급성기뇌졸중
asmGrd03HiraAssessmentGradeoptional혈액투석
asmGrd04HiraAssessmentGradeoptional의료급여정신과
asmGrd05HiraAssessmentGradeoptional수술부위 감염예방 항생제
asmGrd06HiraAssessmentGradeoptional관상동맥우회술
asmGrd07HiraAssessmentGradeoptional급성상기도감염 항생제 처방률
asmGrd08HiraAssessmentGradeoptional주사제 처방률
asmGrd09HiraAssessmentGradeoptional약품목수
asmGrd10HiraAssessmentGradeoptional요양병원
asmGrd12HiraAssessmentGradeoptional대장암
asmGrd13HiraAssessmentGradeoptional위암
asmGrd14HiraAssessmentGradeoptional유방암
asmGrd15HiraAssessmentGradeoptional폐암
asmGrd16objectoptional천식. **이 항목만 등급 표기가 다르다. 등급 체계 자체는 나머지와 같다.** 일반 21개 : 1 2 3 4 5 '등급제외' 천식 : '양호' 2 3 4 5 0 1등급을 '양호' 로, 등급대상 제외를 0 으로 표기할 뿐이다. 그래서 천식에는 1 과 '등급제외' 가 오지 않는다. 가이드가 이 항목만 '(양호한 기관 공개)' 로 표기한 것이 이 뜻이다(나머지 21개는 '(1~5등급, 등급제외)'). **0 은 최하 등급도 값 없음도 아니다.** 0 은 등급제외이고 최하는 5 다. 다른 항목과 비교하려면 '양호'→1, 0→'등급제외' 로 옮겨서 쓴다.
asmGrd17HiraAssessmentGradeoptional만성폐쇄성폐질환
asmGrd18HiraAssessmentGradeoptional폐렴
asmGrd19HiraAssessmentGradeoptional중환자실
asmGrd20HiraAssessmentGradeoptional신생아중환자실
asmGrd21HiraAssessmentGradeoptional마취
asmGrd22HiraAssessmentGradeoptional정신건강 입원영역
asmGrd23HiraAssessmentGradeoptional급성하기도감염 항생제 처방률
asmGrd24HiraAssessmentGradeoptional고혈압·당뇨병
{
  "response": {
    "header": {
      "resultCode": "string",
      "resultMsg": "string"
    },
    "body": {
      "numOfRows": 0,
      "pageNo": 0,
      "totalCount": 0,
      "items": {
        "item": [
          {
            "ykiho": "string",
            "yadmNm": "string",
            "clCd": null,
            "clCdNm": "string",
            "addr": "string",
            "asmGrd01": {},
            "asmGrd03": {},
            "asmGrd04": {},
            "asmGrd05": {},
            "asmGrd06": {},
            "asmGrd07": {},
            "asmGrd08": {},
            "asmGrd09": {},
            "asmGrd10": {},
            "asmGrd12": {},
            "asmGrd13": {},
            "asmGrd14": {},
            "asmGrd15": {},
            "asmGrd16": null,
            "asmGrd17": {},
            "asmGrd18": {},
            "asmGrd19": {},
            "asmGrd20": {},
            "asmGrd21": {},
            "asmGrd22": {},
            "asmGrd23": {},
            "asmGrd24": {}
          }
        ]
      }
    }
  }
}

Playground

Server
Authorization
Variables
Key
Value

Samples

Powered by VitePress OpenAPI

코드 목록 조회

GET
/data-go-kr/hira/codes

로컬 DB 에 미러링한 HIRA 코드. tp 로 종류를 고른다. 응답 item 의 필드명은 종류별 원본 API 와 같다.

Request

🔒 Bearer 인증 필요 · 인증 방법
GET/data-go-kr/hira/codes

Query Parameters

NameTypeRequiredConstraintsDescription
pagenumberoptionaldefault 1페이지 번호
sizenumberoptionalmin 1 · max 100 · default 20페이지 크기
tpstringrequiredenum: addr, class, subject, equipment, specialty, special코드 종류. addr=주소, class=의료기관종별, subject=진료과목, equipment=장비, specialty=전문병원, special=특수진료

Response

200

타입: object

Playground

Server
Authorization
Variables
Key
Value

Samples

Powered by VitePress OpenAPI

지역 목록 조회

GET
/data-go-kr/hira/regions

병원 데이터에서 집계한 시도·시군구 목록(코드 포함). 병원이 1건 이상 있는 지역만 나온다.

Request

🔒 Bearer 인증 필요 · 인증 방법
GET/data-go-kr/hira/regions

Query Parameters

NameTypeRequiredConstraintsDescription
pagenumberoptionaldefault 1페이지 번호
sizenumberoptionalmin 1 · max 100 · default 20페이지 크기

Response

200

HiraRegionResponse

FieldTypeRequiredConstraintsDescription
responseHiraRegionResultrequired

HiraRegionResult

FieldTypeRequiredConstraintsDescription
headerKrDataHeaderrequired
resultCodestringrequired결과 코드. 정상은 00
resultMsgstringrequired결과 메시지
bodyHiraRegionBodyrequired
itemsHiraRegionItemsrequired
itemHiraRegionItem[]required
sidoCdstringrequired시도코드
sidoCdNmstringoptional시도명
sgguCdstringrequired시군구코드
sgguCdNmstringoptional시군구명. 심평원 자체 표기다 (예: 수원팔달구, 광주북구).
hospitalCountnumberrequired이 지역의 병원 수
numOfRowsnumberrequired한 페이지 결과 수
pageNonumberrequired페이지 번호
totalCountnumberrequired전체 결과 수
{
  "response": {
    "header": {
      "resultCode": "00",
      "resultMsg": "NORMAL SERVICE."
    },
    "body": {
      "items": {
        "item": [
          {
            "sidoCd": "110000",
            "sidoCdNm": "서울",
            "sgguCd": "110019",
            "sgguCdNm": "중랑구",
            "hospitalCount": 582
          }
        ]
      },
      "numOfRows": 100,
      "pageNo": 1,
      "totalCount": 259
    }
  }
}

Playground

Server
Authorization
Variables
Key
Value

Samples

Powered by VitePress OpenAPI

병원 진료과목 조회

GET
/data-go-kr/hira/hospitals/{ykiho}/subjects

해당 병원이 진료하는 과목 목록. 응답 구조는 원본 API(진료과목정보)와 동일하다.

Request

🔒 Bearer 인증 필요 · 인증 방법
GET/data-go-kr/hira/hospitals/{ykiho}/subjects

Path Parameters

NameTypeRequiredConstraintsDescription
ykihostringrequired암호화된 요양기호

Response

200

HiraSubjectInfoResponse

FieldTypeRequiredConstraintsDescription
responseHiraSubjectInfoResultoptional

HiraSubjectInfoResult

FieldTypeRequiredConstraintsDescription
headerHiraResultHeaderoptional
resultCodestringoptional결과코드 (정상: 00)
resultMsgstringoptional결과메시지
bodyHiraSubjectInfoBodyoptional
numOfRowsintegeroptional한 페이지 결과 수
pageNointegeroptional현재 페이지 번호
totalCountintegeroptional전체 결과 수
itemsHiraSubjectInfoItemsoptional
itemHiraSubjectInfoItem[]optional
dgsbjtCdstringoptional진료과목코드
dgsbjtCdNmstringoptional진료과목코드명
dgsbjtPrSdrCntintegeroptional과목별 의사수
cdiagDrCntintegeroptional선택진료 의사수
{
  "response": {
    "header": {
      "resultCode": "string",
      "resultMsg": "string"
    },
    "body": {
      "numOfRows": 0,
      "pageNo": 0,
      "totalCount": 0,
      "items": {
        "item": [
          {
            "dgsbjtCd": "string",
            "dgsbjtCdNm": "string",
            "dgsbjtPrSdrCnt": 0,
            "cdiagDrCnt": 0
          }
        ]
      }
    }
  }
}

Playground

Server
Authorization
Variables
Key
Value

Samples

Powered by VitePress OpenAPI