Service
Estimate fares between two points, dispatch a real taxi, track the ride, and cancel when needed.
99.71%30-day uptimeAvg response215ms
Selecting a row opens the reference for that API.
| Method | API | Path | Summary |
|---|---|---|---|
| POST | /v1/swing-taxi/cancel_ride | Cancels a dispatched taxi ride call. Use when the user wants to cancel a taxi that was called with swing-taxi:dispatch_taxi; requires that ride's ride_call_id. Do NOT use to check whether a ride is still active — use swing-taxi:get_ride_status instead. Returns result (ok when the cancellation is accepted) and a Korean summary. | |
| POST | /v1/swing-taxi/dispatch_taxi | Dispatches a real taxi to the pickup address — this creates a live ride call with real cost and starts searching for a driver. Use only when the user explicitly asks to call or book a taxi and the passenger name, Korean mobile phone number, and a stable external_user_id are available; origin and destination each require an address. Do NOT use for price or travel-time quotes — use swing-taxi:estimate_fare instead. Returns ride_call_id (needed by swing-taxi:get_ride_status and swing-taxi:cancel_ride), the fare estimate, Kakao Map links, and the parameters used. | |
| POST | /v1/swing-taxi/estimate_fare | Estimates the taxi fare, travel time, and route distance between an origin and a destination. Use when the user wants to know how much a taxi would cost or how long the trip would take; each point accepts an address or a lat/lng pair, and taxi_call_type is optional. Do NOT use to actually call a taxi — use swing-taxi:dispatch_taxi instead. Returns estimate_price, toll_fare, distance, total_time, the resolved coordinates, Kakao Map links, and a Korean summary. | |
| POST | /v1/swing-taxi/get_ride_status | Checks the current status of a dispatched ride call. Use after swing-taxi:dispatch_taxi with its ride_call_id to track dispatch progress, driver allocation, boarding, and completion. Do NOT use to cancel the ride — use swing-taxi:cancel_ride instead. Returns status, status_phase, status_text, estimate_driver_time, and driver details (name, phone, vehicle, photo, live map link) once a driver is allocated. |
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.
