Service
data.go.kr 게이트웨이의 공식 TAGO 열차정보(TrainInfo) 서비스를 기반으로 한국 시외 열차(KTX·일반열차) 시간표, 역, 도시, 열차 등급 코드를 정규화해 제공합니다.
92.86%30일 가동률평균 응답228ms
행을 선택하면 해당 API의 레퍼런스로 이동합니다.
| Method | API | Path | Summary |
|---|---|---|---|
| POST | /v1/korea-train-schedule/cities | Lists Korean city/province codes used by the TAGO train station catalog. Use when you need city_code values before listing stations or when discovering which cities have intercity rail stations. Do NOT use for station ids — use korea-train-schedule:stations with a known city_code instead. This catalog covers intercity rail cities only, so do not use it for subway networks or for geocoding addresses (use a maps geocoder). Returns the complete unpaginated city catalog (city_code, city_name) — upstream GetCtyCodeList ignores paging. | |
| POST | /v1/korea-train-schedule/search-schedule | Searches intercity train timetables between two TAGO station ids on a calendar departure date, optionally filtered by train grade. Use when planning KTX or conventional rail trips with known station_ids and a near-term date. Do NOT use for seat availability, booking, subway, or multi-day open-ended calendars — TAGO publishes a short planning window. Returns ISO-8601 KST departure/arrival times, train grade name, optional train number, and adult_fare_krw (0 often means fare not published). Station ids must come from korea-train-schedule:stations. | |
| POST | /v1/korea-train-schedule/stations | Lists intercity train stations for a TAGO city_code, including station_id values required by korea-train-schedule:search-schedule. Use when resolving a station name in a city to its NAT-style station_id, or browsing stations in Seoul/Busan/etc. Do NOT use for subway station codes or realtime arrivals — this is intercity rail only. Returns station_id, station_name, and upstream pagination totals (total_count). city_code must come from korea-train-schedule:cities. | |
| POST | /v1/korea-train-schedule/train-grades | Lists train grade codes and Korean names (KTX, ITX, Saemaeul, Mugunghwa, etc.) from TAGO GetVhcleKndList. Use when filtering korea-train-schedule:search-schedule by train_grade_code or explaining grade labels to users. Do NOT use for fare products, seat classes, or subway line names. Returns the complete unpaginated grade catalog (grade_code, grade_name). Filter codes are stable strings such as 00 for KTX. |
sandbox key를 발급받고 첫 예약 생성까지 진행합니다.
파트너 credential은 APIFuse이 보관합니다. 발급받는 것은 하나의 managed key입니다.
예약 확정, 배달 상태 변경 같은 이벤트를 webhook으로 수신합니다.
서비스 장애와 게이트웨이 에러를 하나의 에러 모델로 정규화합니다.
