# 병원 정보 조회

{% hint style="info" %}
캐릭터 인코딩은 UTF-8 을 기본으로 합니다.
{% endhint %}

{% hint style="info" %}
secret key는 ‘서비스콘솔’ – ‘Sub Account’ 생성 시 키를 발급 받을 수 있습니다.
{% endhint %}

<table data-header-hidden data-full-width="true"><thead><tr><th></th><th></th><th></th><th></th></tr></thead><tbody><tr><td><strong>상세기능 번호</strong></td><td>1</td><td><strong>상세기능 유형</strong></td><td>조회 (자료)</td></tr><tr><td><strong>상세기능명(국문)</strong></td><td>병원 정보 조회 서비스</td><td></td><td></td></tr><tr><td><strong>상세기능 설명</strong></td><td>건강보험심사평가원에서 관리하는 병원 정보를 조회하는 서비스입니다.</td><td></td><td></td></tr><tr><td><strong>Call Back URL</strong></td><td>https://i48ojxo10p.apigw.ntruss.com/public_hospital/v1/basic_info</td><td></td><td></td></tr></tbody></table>

## 병원 정보 조회 API

<mark style="color:blue;">`GET`</mark> `https://4vh6qtie3c.apigw.ntruss.com/public_hospital/v1/basic_info`

#### Query Parameters

| Name                                        | Type   | Description       |
| ------------------------------------------- | ------ | ----------------- |
| pageNo<mark style="color:red;">\*</mark>    | string | 페이지번호             |
| numOfRows<mark style="color:red;">\*</mark> | string | 한 페이지 결과 수        |
| zipCd<mark style="color:red;">\*</mark>     | string | 분류코드(활용가이드 참조)    |
| yadmNm<mark style="color:red;">\*</mark>    | string | 병원명(UTF-8 인코딩 필요) |
| emdongNm<mark style="color:red;">\*</mark>  | string | 읍면동명              |
| sgguCd<mark style="color:red;">\*</mark>    | string | 시군구코드             |
| sidoCd<mark style="color:red;">\*</mark>    | string | 시도코드              |
| xPos<mark style="color:red;">\*</mark>      | string | x좌표(소수점 15)       |
| dgsbjtCd<mark style="color:red;">\*</mark>  | string | 진료과목코드(활용가이드 참조)  |
| clCd<mark style="color:red;">\*</mark>      | string | 종별코드(활용가이드 참조)    |
| radius<mark style="color:red;">\*</mark>    | string | 단위 : 미터(m)        |
| yPos<mark style="color:red;">\*</mark>      | string | y좌표(소수점 15)       |

#### Headers

| Name                                            | Type   | Description      |
| ----------------------------------------------- | ------ | ---------------- |
| Authorization<mark style="color:red;">\*</mark> | string | 사용자ID;secret key |

{% tabs %}
{% tab title="200: OK 응답 반환 완료" %}

{% endtab %}
{% endtabs %}

### Response Body

#### header

| 항목명(영문)    | 항목명(국문) | 항목설명  | 타입     |
| ---------- | ------- | ----- | ------ |
| resultMsg  | 결과메세지   | 결과메세지 | string |
| resultCode | 결과코드    | 결과메세지 | string |

#### &#x20;body

| 항목명(영문)    | 항목명(국문)    | 항목설명       | 타입     |
| ---------- | ---------- | ---------- | ------ |
| items      | 결과메세지      | 결과메세지      | string |
| numOfRows  | 한 페이지 결과 수 | 한 페이지 결과 수 | number |
| pageNo     | 페이지 수      | 페이지 수      | number |
| totalCount | 데이터 총 개수   | 데이터 총 개수   | number |

#### &#x20;item

<table data-full-width="false"><thead><tr><th>항목명(영문)</th><th>항목명(국문)</th><th>항목설명</th><th>타입</th></tr></thead><tbody><tr><td>cmdcResdntCnt</td><td>한방레지던트 인원수</td><td>한방레지던트 인원수</td><td>string</td></tr><tr><td>cmdcSdrCnt</td><td>한방전문의 인원수</td><td>한방전문의 인원수</td><td>string</td></tr><tr><td>pnursCnt</td><td>조산사 인원수</td><td>조산사 인원수</td><td>string</td></tr><tr><td>XPos</td><td>x좌표</td><td>x좌표</td><td>string</td></tr><tr><td>YPos</td><td>y좌표</td><td>y좌표</td><td>string</td></tr><tr><td>distance</td><td>거리</td><td>거리</td><td>string</td></tr><tr><td>detyGdrCnt</td><td>치과일반의 인원수</td><td>치과일반의 인원수</td><td>string</td></tr><tr><td>detyIntnCnt</td><td>치과인턴 인원수</td><td>치과인턴 인원수</td><td>string</td></tr><tr><td>detyResdntCnt</td><td>치과레지던트 인원수</td><td>치과레지던트 인원수</td><td>string</td></tr><tr><td>detySdrCnt</td><td>치과전문의 인원수</td><td>치과전문의 인원수</td><td>string</td></tr><tr><td>cmdcGdrCnt</td><td>한방일반의 인원수</td><td>한방일반의 인원수</td><td>string</td></tr><tr><td>cmdcIntnCnt</td><td>한방인턴 인원수</td><td>한방인턴 인원수</td><td>string</td></tr><tr><td>mdeptResdntCnt</td><td>의과레지던트 인원수</td><td>의과레지던트 인원수</td><td>string</td></tr><tr><td>drTotCnt</td><td>의사총수</td><td>의사총수</td><td>string</td></tr><tr><td>mdeptGdrCnt</td><td>의과일반의 인원수</td><td>의과일반의 인원수</td><td>string</td></tr><tr><td>mdeptIntnCnt</td><td>의과인턴 인원수</td><td>의과인턴 인원수</td><td>string</td></tr><tr><td>telno</td><td>전화번호</td><td>전화번호</td><td>string</td></tr><tr><td>hospUrl</td><td>홈페이지</td><td>홈페이지</td><td>string</td></tr><tr><td>estbDd</td><td>개설일자</td><td>개설일자</td><td>string</td></tr><tr><td>sgguCdNm</td><td>시군구명</td><td>시군구명</td><td>number</td></tr><tr><td>emdongNm</td><td>읍면동명</td><td>읍면동명</td><td>string</td></tr><tr><td>postNo</td><td>우편번호</td><td>우편번호</td><td>string</td></tr><tr><td>addr</td><td>주소</td><td>주소</td><td>string</td></tr><tr><td>sidoCdNm</td><td>시도명</td><td>시도명</td><td>number</td></tr><tr><td>sgguCd</td><td>시군구코드</td><td>시군구코드</td><td>number</td></tr><tr><td>ykiho</td><td>암호화된 요양기호</td><td>암호화된 요양기호</td><td>string</td></tr><tr><td>yadmNm</td><td>병원명</td><td>병원명</td><td>string</td></tr><tr><td>clCd</td><td>종별코드</td><td>종별코드</td><td>string</td></tr><tr><td>clCdNm</td><td>종별코드명</td><td>종별코드명</td><td>string</td></tr><tr><td>sidoCd</td><td>시도코드</td><td>시도코드</td><td>number</td></tr><tr><td>mdeptSdrCnt</td><td>의과전문의 인원수</td><td>의과전문의 인원수</td><td>string</td></tr></tbody></table>

### 요청 및 응답 예시

{% tabs %}
{% tab title="URI" %}
<https://i48ojxo10p.apigw.ntruss.com/public\\_hospital/v1/basic\\_info?numOfRows=10>
{% endtab %}

{% tab title="Response" %}

```json
{
  "response": {
      "header": {
           "resultCode": "00",
           "resultMsg": "NORMAL SERVICE."
      },
      "body": {
           "pageNo": 1,
           "totalCount": 76489,
           "items": {
              "item": [
                  {
                      "mdeptGdrCnt": 0,
                      "pnursCnt": 0,
                      "clCd": 1,
                      "mdeptSdrCnt": 235,
                      "ykiho": "JDQ4MTYyMiM1MSMkMSMkMCMkODkkMzgxMzUxIzExIyQxIyQzIyQ3OSQyNjE4MzIjNDEjJDEjJDgjJDgz",
                      "clCdNm": "상급종합",
                      "mdeptResdntCnt": 72,
                      "telno": "032-1544-9004",
                      "cmdcSdrCnt": 0,
                      "hospUrl": "http://www.cmcism.or.kr/",
                      "YPos": 37.4848309,
                      "detyIntnCnt": 0,
                      "cmdcIntnCnt": 0,
                      "sidoCd": 220000,
                      "estbDd": 19810806,
                      "emdongNm": "부평동",
                      "drTotCnt": 333,
                      "sgguCd": 220003,
                      "cmdcGdrCnt": 0,
                      "addr": "인천광역시 부평구 동수로 56 (부평동)",
                      "mdeptIntnCnt": 23,
                      "detyResdntCnt": 0,
                      "detySdrCnt": 2,
                      "yadmNm": "가톨릭대학교인천성모병원",
                      "postNo": 21431,
                      "detyGdrCnt": 1,
                      "cmdcResdntCnt": 0,
                      "XPos": 126.7248987,
                      "sidoCdNm": "인천",
                      "sgguCdNm": "인천부평구"
                  },
                  {
                      "mdeptGdrCnt": 3,
                      "pnursCnt": 0,
                      "clCd": 1,
                      "mdeptSdrCnt": 158
                      "ykiho": "JDQ4MTYyMiM1MSMkMSMkNCMkODkkMzgxMzUxIzExIyQxIyQzIyQ4OSQ0NjEwMDIjNDEjJDEjJDgjJDgz",
                      "clCdNm": "상급종합",
                      "mdeptResdntCnt": 34,
                      "telno": "033-610-3114",
                      "cmdcSdrCnt": 0,
                      "hospUrl": "http://www.gnah.co.kr",
                      "YPos": 37.8184325,
                      "detyIntnCnt": 0,
                      "cmdcIntnCnt": 0,
                      "sidoCd": 320000,
                      "estbDd": 19960730,
                      "drTotCnt": 197,
                      "sgguCd": 320100,
                      "cmdcGdrCnt": 0,
                      "addr": "강원도 강릉시 사천면 방동길 38 ()",
                      "mdeptIntnCnt": 0,
                      "detyResdntCnt": 0,
                      "detySdrCnt": 2,
                      "yadmNm": "강릉아산병원",
                      "postNo": 25440,
                      "detyGdrCnt": 0,
                      "cmdcResdntCnt": 0,
                      "XPos": 128.8578411,
                      "sidoCdNm": "강원",
                      "sgguCdNm": "강릉시"
                  }
              ]
          },
           "numOfRows": 2
      }
  }
}
```

{% endtab %}
{% endtabs %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://developer.apiplex.net/ko/marketplace/public-api-market/clinic-info.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.