Hans API

Appearance

hira ​

건강보험심사평가원(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
pagenumber-default 1페이지 번호
sizenumber-min 1 · max 100 · default 20페이지 크기

Response

200

HiraHospitalListResponse

FieldTypeRequiredDescription
responseHiraHospitalListResult-

HiraHospitalListResult

FieldTypeRequiredDescription
headerHiraResultHeader-
└─resultCodestring-결과코드 (정상: 00)
└─resultMsgstring-결과메시지
bodyHiraHospitalListBody-
└─numOfRowsinteger-한 페이지 결과 수
└─pageNointeger-현재 페이지 번호
└─totalCountinteger-전체 결과 수
└─itemsHiraHospitalListItems-
└─itemHiraHospitalItem[]-
└─ykihostring-암호화된 요양기호. 상세정보 조회(MadmDtlInfoService2.8)의 키다.
└─yadmNmstring-병원명
└─clCdstring-종별코드
└─clCdNmstring-종별코드명 (예: 상급종합)
└─sidoCdstring-시도코드
└─sidoCdNmstring-시도명
└─sgguCdstring-시군구코드
└─sgguCdNmstring-시군구명
└─emdongNmstring-읍면동명
└─postNostring-우편번호
└─addrstring-주소
└─telnostring-전화번호
└─hospUrlstring-홈페이지
└─estbDdstring-개설일자 (YYYYMMDD)
└─drTotCntinteger-의사총수
└─mdeptGdrCntinteger-의과일반의 인원수
└─mdeptIntnCntinteger-의과인턴 인원수
└─mdeptResdntCntinteger-의과레지던트 인원수
└─mdeptSdrCntinteger-의과전문의 인원수
└─detyGdrCntinteger-치과일반의 인원수
└─detyIntnCntinteger-치과인턴 인원수
└─detyResdntCntinteger-치과레지던트 인원수
└─detySdrCntinteger-치과전문의 인원수
└─cmdcGdrCntinteger-한방일반의 인원수
└─cmdcIntnCntinteger-한방인턴 인원수
└─cmdcResdntCntinteger-한방레지던트 인원수
└─cmdcSdrCntinteger-한방전문의 인원수
└─pnursCntinteger-공식 가이드(2021)에 없는 필드. 값이 대부분 0 이고 드물게 한 자릿수인 것으로 보아 전문간호사 수로 추정된다. (2026-07 확인)
└─XPosstring-x좌표 (경도). 대문자 X 로 시작한다.
└─YPosstring-y좌표 (위도). 대문자 Y 로 시작한다.
└─distancestring-거리(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
ykihostring필수암호화된 요양기호. 목록 응답의 ykiho 를 그대로 쓴다.

Response

200

HiraHospitalListResponse

FieldTypeRequiredDescription
responseHiraHospitalListResult-

HiraHospitalListResult

FieldTypeRequiredDescription
headerHiraResultHeader-
└─resultCodestring-결과코드 (정상: 00)
└─resultMsgstring-결과메시지
bodyHiraHospitalListBody-
└─numOfRowsinteger-한 페이지 결과 수
└─pageNointeger-현재 페이지 번호
└─totalCountinteger-전체 결과 수
└─itemsHiraHospitalListItems-
└─itemHiraHospitalItem[]-
└─ykihostring-암호화된 요양기호. 상세정보 조회(MadmDtlInfoService2.8)의 키다.
└─yadmNmstring-병원명
└─clCdstring-종별코드
└─clCdNmstring-종별코드명 (예: 상급종합)
└─sidoCdstring-시도코드
└─sidoCdNmstring-시도명
└─sgguCdstring-시군구코드
└─sgguCdNmstring-시군구명
└─emdongNmstring-읍면동명
└─postNostring-우편번호
└─addrstring-주소
└─telnostring-전화번호
└─hospUrlstring-홈페이지
└─estbDdstring-개설일자 (YYYYMMDD)
└─drTotCntinteger-의사총수
└─mdeptGdrCntinteger-의과일반의 인원수
└─mdeptIntnCntinteger-의과인턴 인원수
└─mdeptResdntCntinteger-의과레지던트 인원수
└─mdeptSdrCntinteger-의과전문의 인원수
└─detyGdrCntinteger-치과일반의 인원수
└─detyIntnCntinteger-치과인턴 인원수
└─detyResdntCntinteger-치과레지던트 인원수
└─detySdrCntinteger-치과전문의 인원수
└─cmdcGdrCntinteger-한방일반의 인원수
└─cmdcIntnCntinteger-한방인턴 인원수
└─cmdcResdntCntinteger-한방레지던트 인원수
└─cmdcSdrCntinteger-한방전문의 인원수
└─pnursCntinteger-공식 가이드(2021)에 없는 필드. 값이 대부분 0 이고 드물게 한 자릿수인 것으로 보아 전문간호사 수로 추정된다. (2026-07 확인)
└─XPosstring-x좌표 (경도). 대문자 X 로 시작한다.
└─YPosstring-y좌표 (위도). 대문자 Y 로 시작한다.
└─distancestring-거리(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/codes

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

Request

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

Query Parameters

NameTypeRequiredConstraintsDescription
pagenumber-default 1페이지 번호
sizenumber-min 1 · max 100 · default 20페이지 크기
tpstring필수enum: 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
pagenumber-default 1페이지 번호
sizenumber-min 1 · max 100 · default 20페이지 크기

Response

200

HiraRegionResponse

FieldTypeRequiredDescription
responseHiraRegionResult필수

HiraRegionResult

FieldTypeRequiredDescription
headerKrDataHeader필수
└─resultCodestring필수결과 코드. 정상은 00
└─resultMsgstring필수결과 메시지
bodyHiraRegionBody필수
└─itemsHiraRegionItems필수
└─itemHiraRegionItem[]필수
└─sidoCdstring필수시도코드
└─sidoCdNmstring-시도명
└─sgguCdstring필수시군구코드
└─sgguCdNmstring-시군구명. 심평원 자체 표기다 (예: 수원팔달구, 광주북구).
└─hospitalCountnumber필수이 지역의 병원 수
└─numOfRowsnumber필수한 페이지 결과 수
└─pageNonumber필수페이지 번호
└─totalCountnumber필수전체 결과 수
{
  "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
ykihostring필수암호화된 요양기호

Response

200

HiraSubjectInfoResponse

FieldTypeRequiredDescription
responseHiraSubjectInfoResult-

HiraSubjectInfoResult

FieldTypeRequiredDescription
headerHiraResultHeader-
└─resultCodestring-결과코드 (정상: 00)
└─resultMsgstring-결과메시지
bodyHiraSubjectInfoBody-
└─numOfRowsinteger-한 페이지 결과 수
└─pageNointeger-현재 페이지 번호
└─totalCountinteger-전체 결과 수
└─itemsHiraSubjectInfoItems-
└─itemHiraSubjectInfoItem[]-
└─dgsbjtCdstring-진료과목코드
└─dgsbjtCdNmstring-진료과목코드명
└─dgsbjtPrSdrCntinteger-과목별 의사수
└─cdiagDrCntinteger-선택진료 의사수
{
  "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