Service
지역, 이름, 주소로 전국 동물병원을 찾고, 주변의 영업 중인 병원과 병원의 인허가 이력을 확인합니다.
99.03%30일 가동률평균 응답266ms
행을 선택하면 해당 API의 레퍼런스로 이동합니다.
| Method | API | Path | Summary |
|---|---|---|---|
| POST | /v1/korea-animal-hospital/get-animal-hospital | Gets the full licence record of one animal hospital by hospital_id. Use when you already have a hospital_id from a search and need its status history, floor area or update times. Do NOT use to find hospitals; use search-animal-hospitals or search-animal-hospitals-nearby. Returns the hospital fields plus suspension, closure, cancellation and reopening dates, floor area and record update times. Closed hospitals are found too. | |
| POST | /v1/korea-animal-hospital/list-region-codes | Lists the region codes the animal hospital register is filed under, with province and district names. Use when you need a region_code for another operation or a region name was ambiguous. Do NOT use to find hospitals. Returns regions with region_code, name, level, province and district names. Codes reflect the 2026 Gwangju and Jeollanam-do merger. | |
| POST | /v1/korea-animal-hospital/search-animal-hospitals | Searches the national animal hospital licence register by region, hospital name, road address, business status, licence date and the date the register last refreshed a record. Use when the user wants veterinary clinics in a district or city, a clinic by name, newly licensed clinics, or records that changed recently. Do NOT use for distance from a point; use search-animal-hospitals-nearby instead, or for a past date; use search-animal-hospitals-as-of. Returns hospitals with id, name, status and detailed status, addresses, phone, coordinates and refresh time, plus page, total_count and has_more. Results default to open hospitals; the register is refreshed daily. | |
| POST | /v1/korea-animal-hospital/search-animal-hospitals-as-of | Searches the animal hospital register as it stood at the end of a past date (2026-01-01 to yesterday) in one region, by name, business status, licence date and refresh date. Use when the user asks whether a hospital was open on a given day or how a district's hospitals looked earlier this year. Do NOT use for today's register; use search-animal-hospitals. Returns each hospital's full record as of that date (status, closure and suspension dates included), plus page, total_count and has_more. A region is required and the road-address filter is not available on past dates. |
sandbox key를 발급받고 첫 예약 생성까지 진행합니다.
파트너 credential은 APIFuse이 보관합니다. 발급받는 것은 하나의 managed key입니다.
예약 확정, 배달 상태 변경 같은 이벤트를 webhook으로 수신합니다.
서비스 장애와 게이트웨이 에러를 하나의 에러 모델로 정규화합니다.
| POST | /v1/korea-animal-hospital/search-animal-hospitals-nearby | Finds open animal hospitals within a radius of a point, closest first. Use when the user asks for a vet near a location and you know the district it is in. Do NOT use to list a whole region or search by name; use search-animal-hospitals instead. Returns hospitals with distance_meters plus matched_count and scan_complete. The region must contain the point; scan_complete is false when the region is larger than one search covers. |