XML

건강보험심사평가원_약국정보서비스

QuickAISummary

관심목록에 추가

오픈 API 정보

데이터 오류·개선 의견이 있으신가요?

기본 정보

OpenAPI 명
건강보험심사평가원_약국정보서비스
분류체계
보건 - 건강보험
제공기관
건강보험심사평가원
관리부서명
빅데이터실
관리부서 전화번호

상세 및 제공정보

설명
건강보험심사평가원에서 관리하는 약국 정보를 조회할 수 있는 서비스입니다. - 국민건강보험법 제 43조(요양기관 현황에 대한 신고) 및 동법 시행규칙 제 12조(요양기관 현황 신고 등)에 의해 요양기관이 건강보험심사평가원에 신고한 기준으로 작성되었습니다. - 요양기호는 1:1로 매칭한 암호화된 요양기호로 제공하고 있으며, 별도의 복호화 방법 또는 요양기호는 제공하고 있지 않습니다. - 지역코드 등 API 활용을 위한 코드는 보건의료빅데이터개방시스템(opendata.hira.or.kr) > 서비스 소개 > 용어설명 > 코드조회를 참고하여 주시기 바랍니다.
API 유형
REST
데이터 포맷
XML
공간범위
-
시간범위
-
키워드
요양기관,약국,의료자원,보건의료빅데이터,의료정보
활용신청 수
4060
등록일
2016-12-28
수정일
2026-05-12

이용 조건 및 라이선스 정보

비용부과유무
무료
이용허락범위

공공저작물 : 출처표시 (제 1유형)
심의유형
개발단계 : 자동승인 / 운영단계 : 심의승인
신청 가능 트래픽
개발계정 : 10,000 / 운영계정 : 활용사례 등록시 신청하면 트래픽 증가 가능

참고문서

OpenAPI활용가이드_건강보험심사평가원(약국정보서비스).docx

표준 메타데이터

※ 데이터 연계 및 검색을 위한 표준 메타데이터입니다.

Schema.org DCAT

활용 정보

API 서비스

약국 검색결과 제공 (약국명,주소,전화번호,URL)

API 기본 정보

활용승인 절차
개발단계 : 자동승인 / 운영단계 : 심의승인
신청 가능 트래픽
개발계정 : 10,000 / 운영계정 : 활용사례 등록시 신청하면 트래픽 증가 가능
요청주소
https://apis.data.go.kr/B551182/pharmacyInfoService/getParmacyBasisList
서비스 URL
https://apis.data.go.kr/B551182/pharmacyInfoService

요청변수(Request Parameter)

해당 오픈API의 요청변수(Request Parameter) 항목에 대한 표로, 국문항목명, 영문 항목명, 항목크기, 항목구분, 샘플데이터, 항목 설명순으로 나열됩니다.
항목명(국문)	항목명(영문)	항목크기	항목구분	샘플데이터	항목설명
서비스키	ServiceKey	400	필수	-	서비스키
페이지 번호	pageNo	4	옵션	1	페이지 번호
한 페이지 결과 수	numOfRows	4	옵션	10	한 페이지 결과 수
시도코드	sidoCd	6	옵션	110000	시도코드
시군구코드	sgguCd	6	옵션	110019	시군구코드
읍면동명	emdongNm	100	옵션	신내동	읍면동명
병원명	yadmNm	100	옵션	온누리건강	병원명
x좌표	xPos	16	옵션	127.0965441345503	x좌표
y좌표	yPos	18	옵션	37.60765568913871	y좌표
반경	radius	10	옵션	3000	반경

출력결과(Response Element)

해당 오픈API의 출력결과(Response Element) 항목에 대한 표로, 국문항목명, 영문 항목명, 항목크기, 항목구분, 샘플데이터, 항목 설명순으로 나열됩니다.
항목명(국문)	항목명(영문)	항목크기	항목구분	샘플데이터	항목설명
결과코드	resultCode	5	필수	00	결과코드
결과메시지	resultMsg	50	필수	NORMAL SERVICE	결과메시지
한 페이지 결과 수	numOfRows	2	옵션	10	한 페이지 결과 수
페이지 번호	pageNo	5	옵션	1	페이지 번호
총건수	totalCount	7	옵션	2	총건수
리스트 항목	Items	-	필수	-	리스트 항목

오픈 API에 대한 에러코드를 에러메시지, 에러코드, 설명 순으로 안내하는 표입니다.
에러메시지	에러코드	설명
APPLICATION_ERROR	01	GW 내부 처리 중 예기치 않은 오류가 발생했습니다. 잠시 후 다시 호출하고, 문제가 반복되면 활용지원센터로 문의해 주세요.
HTTP_ERROR	04	허용되지 않은 HTTP 요청이거나 기관 API 응답 처리에 실패했습니다. 요청 방식과 호출 URL을 확인해 주세요.
SERVICETIMEOUT_ERROR	05	기관 API 또는 GW 연계 서비스와의 연결에 실패했거나 응답 대기시간을 초과했습니다. 잠시 후 다시 호출해 주세요.
INVALID_REQUEST_PARAMETER_ERROR	10	요청 파라미터의 값이나 형식이 올바르지 않습니다. API 명세에서 파라미터 이름, 형식 및 허용값을 확인해 주세요.
NO_OPENAPI_SERVICE_ERROR	12	요청한 오픈API 서비스가 존재하지 않거나 폐기되었습니다. 호출 URL에 오타가 없는지 확인해 주세요.
SERVICE_KEY_IS_NULL	20	요청에 API 인증키가 포함되지 않았습니다. 공공데이터포털에서 발급받은 인증키를 요청 파라미터에 포함해 주세요.
PERMISSION_DENIED	20	GW 접근 권한 검사에서 요청이 거부되었습니다. 해당 API의 활용신청 및 접근 권한을 확인해 주세요.
LIMITED_NUMBER_OF_SERVICE_REQUESTS_EXCEEDS_ERROR	22	API 서비스의 일일 호출 허용량을 초과했습니다. 호출량이 초기화된 이후 다시 이용하거나 트래픽 증설을 신청해 주세요.
LIMITED_NUMBER_OF_SERVICE_REQUESTS_PER_SECOND_EXCEEDS_ERROR	23	짧은 시간에 많은 요청이 발생하여 초당 호출 허용량을 초과했습니다. 잠시 후 다시 호출해 주세요.
BLACKLIST_IP_ACCESS_ERROR	29	차단된 IP에서 호출한 요청입니다. 호출 서버의 IP를 확인하고, 차단 해제가 필요한 경우 활용지원센터로 문의해 주세요.

인증 에러

오픈 API에 대한 인증 에러코드를 에러메시지, 에러코드, 설명 순으로 안내하는 표입니다.
에러메시지	에러코드	설명
SERVICE_ACCESS_DENIED_ERROR	20	해당 API 서비스에 대한 이용 권한이 확인되지 않습니다. 활용신청 여부와 승인 또는 일시중지 상태를 확인해 주세요.
SERVICE_KEY_IS_NOT_REGISTERED_ERROR	30	등록되지 않은 API 인증키입니다. 인증키가 정확한지와 해당 서비스의 활용신청이 정상적으로 완료되었는지 확인해 주세요.
DEADLINE_HAS_EXPIRED_ERROR	31	API 인증키의 사용 기한이 만료되었습니다. 공공데이터포털에서 이용 기간을 확인하거나 갱신해 주세요.