Service
Connect your Kakao account to search places, compare on-site-payment ride options, and request, track, or cancel Kakao T taxis.
No measurements yet. Once the service goes live, its status will appear here.
Selecting a row opens the reference for that API.
| Method | API | Path | Summary |
|---|---|---|---|
| POST | Kakao T Active Rides | /v1/kakaot/active-rides | Lists the Kakao T taxi rides currently active for the connected account. Use when a kakaot:request-ride response was lost or the ride ID is unknown. Do NOT use to poll a ride whose ID you already have — use kakaot:ride-status instead. Returns rides, which is an empty list when there is no active ride. Requires a Kakao T connection. |
| POST | /v1/kakaot/cancel-ride | Cancels a Kakao T ride request using the appropriate action for its current state. Use when the user asks to cancel a requested or dispatched taxi. Do NOT use only to check the cancellation fee — use kakaot:cancellation-policy instead. Cancellation may incur a fee after a driver is assigned; call kakaot:cancellation-policy and confirm with the user first. Returns ride_id and cancelled. Requires a Kakao T connection. | |
| POST | /v1/kakaot/cancellation-policy | Fetches the cancellation fee notice Kakao T shows for a ride. Use before kakaot:cancel-ride and relay the notice to the user. Do NOT use to cancel the ride — use kakaot:cancel-ride instead. Returns notices and an optional title. Requires a Kakao T connection. | |
| POST | /v1/kakaot/connection-health | Returns the Kakao T user identifiers for a healthy connection. | |
| POST | /v1/kakaot/request-ride | Requests an immediate on-site-payment taxi for one service_type offered under a ride_option_token from kakaot:ride-options. Use only after the user has confirmed the route and estimate. Do NOT use to check fares or availability — use kakaot:ride-options instead. APIFuse rechecks that no ride is active and that service, payment eligibility, and fare are unchanged. Retrying with the same ride_option_token returns the original ride instead of dispatching twice. Card details are never accepted. This dispatches a real taxi. Returns ride_id. Requires a Kakao T connection. | |
| POST | /v1/kakaot/reverse-geocode | Reverse-geocodes coordinates into a Kakao T address and nearby place and returns it under a short location_token with location_key "1" for ride-option lookup. Use when the user picks a point on a map or supplies coordinates. Do NOT use for a keyword, address text, or landmark name — use kakaot:search-address instead. Returns location_token, location, and expires_at. Requires a Kakao T connection. | |
| POST | /v1/kakaot/ride-options | Lists currently available on-site-payment taxi services and estimated fares for a route. origin and destination each take the location_token from kakaot:search-address or kakaot:reverse-geocode plus the location_key of the chosen row. Use when the user wants a fare estimate or must choose a service before requesting a taxi. Do NOT use to dispatch a taxi — use kakaot:request-ride with the returned ride_option_token and a listed service_type instead. One short ride_option_token keeps the route, every offered service, and the confirmed estimates server-side, so coordinates and internal IDs are not copied into the next call. Returns ride_options, plus ride_option_token, route, and expires_at when at least one option is available. Requires a Kakao T connection. | |
| POST | /v1/kakaot/ride-status | Fetches the current status of a requested Kakao T ride by ride_id. Use after kakaot:request-ride until a driver is assigned or the request ends. Do NOT use when the ride ID is unknown — use kakaot:active-rides instead. Returns ride_id, status, and status_updated_at when Kakao T reports it as an ISO 8601 timestamp with a UTC offset. Requires a Kakao T connection. | |
| POST | /v1/kakaot/search-address | Searches Kakao T places and addresses by keyword and returns one normalized location list. Use when the user names a place, address, or landmark. Do NOT use for a point picked on a map or raw coordinates — use kakaot:reverse-geocode instead. The response carries one short location_token for the whole result set and a plain location_key on every row; upstream place IDs remain private. Pass the location_token together with the chosen location_key to kakaot:ride-options. An optional near coordinate biases the search toward that point. Returns location_token, locations, and expires_at. Requires a Kakao T connection. |
Scopes define which services and APIs a key may call.
Retry rules and backoff behaviour for idempotent calls.
Receive events such as reservation confirmations and delivery updates.
