Service
Real-time bus arrival boards, the stops of each city with search by name, number or location, the routes of each stop, and each route's stops, first and last bus, headways and live bus positions in South Korean cities outside Seoul, from the national public transport information service.
78.08%30-day uptimeAvg response1615ms
Selecting a row opens the reference for that API.
| Method | API | Path | Summary |
|---|---|---|---|
| POST | /v1/korea-bus-arrival/approaching-buses | Shows the buses of one route that are heading to one stop in a South Korean city outside Seoul, with where each bus is now. Use when someone follows one route to one stop and wants the positions of the buses about to reach it. Do NOT use for arrival times (use stop-arrivals with route_id) or for Seoul. Returns the stop name and buses with route number, route type and coordinates; a bus is listed only while this stop is its next one, so the list is often empty. | |
| POST | /v1/korea-bus-arrival/cities | Lists every South Korean city whose bus stops publish real-time arrivals here, with the city code each arrival request needs. Use when you need a city_code for stop-arrivals or want to check whether a city is covered. Do NOT use for Seoul, which is not in this list. Returns cities with city_code and city_name. | |
| POST | /v1/korea-bus-arrival/route-bus-locations | Shows where every bus of one route is right now in a South Korean city outside Seoul, with the stop each bus was last reported at. Use when someone asks where the buses of a route are. Do NOT use for arrival times at a stop (use stop-arrivals) or for Seoul. Returns buses with vehicle number, the current stop's id, name and sequence, and coordinates when reported; an empty list means no bus of the route is running now. | |
| POST | /v1/korea-bus-arrival/route-details | Shows one bus route in a South Korean city outside Seoul: its number, type, end stops, first and last bus time and the minutes between buses on weekdays, Saturdays and Sundays. Use when someone asks when a route starts or stops running or how often it comes. Do NOT use for real-time arrivals (use stop-arrivals) or for Seoul. Returns the route with first_bus_time, last_bus_time and three interval fields in minutes; an unknown route_id is a NO_DATA error. | |
| POST |
Issue a sandbox key and make your first reservation.
APIFuse holds the partner credentials. You hold one managed key.
Receive events such as reservation confirmations and delivery updates.
Service outages and gateway errors normalise into one error model.
Observed on this service over the last 30 days.
| /v1/korea-bus-arrival/route-stops |
| Lists every stop of one bus route in a South Korean city outside Seoul, in route order, with the direction each stop belongs to. Use when someone asks where a route goes or which stops it passes. Do NOT use for the routes of one stop (use stop-routes) or for Seoul. Returns stops with stop_id, stop_name, stop_number, sequence, direction (up or down) and coordinates. |
| POST | /v1/korea-bus-arrival/search-routes | Lists the bus routes of one South Korean city outside Seoul, optionally narrowed by part of the route number, with each route's end stops and first and last bus time. Use when someone names a route number and you need its route_id for route-details, route-stops, route-bus-locations or stop-arrivals, or wants every route of a city. Do NOT use for Seoul routes or for the routes of one stop (use stop-routes). Returns routes with route_id, route_number, route type, end stops and first and last bus times, one page at a time with total_count and has_more. |
| POST | /v1/korea-bus-arrival/search-stops | Lists the bus stops of one South Korean city outside Seoul, optionally narrowed by part of the stop name, by the stop number printed at the stop, or both. Use when you know a stop's name or number but need its stop_id for stop-arrivals or stop-routes, or want to page through every stop of a city. Do NOT use for Seoul stops or to find stops around a location (use search-stops-nearby). Returns stops with stop_id, stop_name, stop_number and coordinates, one page at a time with total_count and has_more. |
| POST | /v1/korea-bus-arrival/search-stops-nearby | Lists the bus stops within about 500 metres of a point in South Korea outside Seoul, nearest first, from every city around it. Use when someone gives a place or coordinates and wants the closest stops. Do NOT use to search by stop name (use search-stops) or for Seoul. Returns stops with stop_id, stop_name, stop_number, the city_code to use with stop-arrivals, coordinates and distance_meters; an empty list means no stop within the radius. |
| POST | /v1/korea-bus-arrival/stop-arrivals | Shows the next bus of every route serving one bus stop, soonest first, in a South Korean city outside Seoul. Use when someone asks when the next bus comes at a stop they can identify by city code and stop id, optionally for one route. Do NOT use for Seoul stops or for timetables. Returns stop_name and arrivals with route number, route type, low-floor flag, stops to go, seconds to go and estimated arrival time; an empty list means no bus is on its way right now, which also happens for an unknown stop id. |
| POST | /v1/korea-bus-arrival/stop-routes | Lists every bus route that serves one bus stop in a South Korean city outside Seoul, in route number order. Use when someone asks which buses stop at a stop, or needs a route_id to narrow stop-arrivals. Do NOT use for real-time arrivals (use stop-arrivals) or for Seoul. Returns routes with route_id, route_number, route type and the route's first and last stop; an empty list also means an unknown stop id. |