The rider's saved places (no query: Home and any the rider named, with their labels), or Uber's place search (query; around near, else around Uber's guess of the rider's position). Each place has an id (a Google place id) to pass as a pickup or drop-off, a name and address, and for airports the terminals per airline.

Every ride option Uber offers for this trip right now: name, tier, seats, live price (fixed upfront price, or a range for a metered taxi), pickup ETA and arrival time, with the pickup and drop-off as Uber matched them (check them; free-text matches list alternatives). For a future pickup supply pickup_at AND timezone: returns native Reserve prices and terms, never current fares. Read-only; use uber_request_ride for now, uber_reserve_ride for future pickup.

Request a real Uber ride, in two calls. Without confirm: a preview with the current price, the places, the payment method and a confirm_token; nothing is booked. With confirm (after the person's explicit yes to that preview, same arguments): books it, unless the price rose (a fresh preview comes back instead) or a cap would be passed. Sends a car and charges the payment method.

Native Uber Reserve. First call: pickup, dropoff, option, exact ISO pickup_at with offset, IANA timezone, optional payment. Returns a preview only. Show the full date/time/zone, route, fare, payment and terms and wait for approval. Second call: ONLY confirm=; submits that stored proposal after fresh checks. If the price rose, nothing is submitted; review the returned fresh preview and obtain approval again. Never retry an unknown outcome. Uber holding a reservation does not guarantee a driver. No flight tracking, recurring rides, specialty products or automatic replacement bookings.

Read a reservation by reservation_id (from booking or uber_trips.upcoming). Returns Uber's status, pickup time/zone, driver assignment and trip ID. Missing data is not proof of cancellation.

Cancel a specific future reservation. Without confirm: preview the reservation and current cancellation fee. After approval: same id and confirm token. Changed terms require a new preview; cancellation remains available while booking is frozen. Never retry an unknown outcome without checking Uber.

Read a fresh snapshot of the current ride. trip.pickup_arrival gives the car's state, eta_minutes and estimated_at when approaching pickup; arrived means the car is already there. Once OnTrip, trip.destination_arrival gives eta_seconds and estimated_at for destination arrival. checked_at is when the server read the estimate; times use ISO 8601 UTC and estimates can change. Missing estimates are unavailable, never zero. Also driver, car/plate, PIN, fare and stops. state alone when no ride exists. Use this same read-only tool for 'when will my car arrive?' and 'when will we reach the destination?'.

Cancel the current ride, in two calls. Without confirm: the ride and Uber's cancellation notice (any fee) with a confirm_token; nothing is cancelled. With confirm (after the person's yes): cancels it.

Upcoming (first page) and past trips, newest first. Page back with next_cursor. include_details adds each past ride's category, receipt vehicle, route and offset-bearing times in details; costs one extra paced read per past ride. Missing trips have details_error; other errors stop the call. Times on cancelled/upcoming rides may be requested or scheduled times, never proof of travel.

One trip: status, fare, ride category (product), receipt vehicle description/year when supplied, driver, pickup/drop-off/stops, distance and duration. times has ISO 8601 begin_at/dropoff_at in the requested zone (default UTC); started_at/ended_at retain Uber's original text. Cancelled/upcoming begin times may be requested/scheduled, never proof of pickup. A receipt vehicle description can just repeat the category; never infer a make, model or plate that Uber did not supply.

The signed-in rider: first name, rating, completed trips, Uber One, payment methods (id, name, type, which one the app uses), Uber Cash, any money owed, and this server's booking caps.

The authenticated My connections link. Give the person the url and nothing else. The account owner starts their own Uber sign-in from that page; asking for this link starts, replaces and cancels nothing. Use it when a tool says not_signed_in or session_expired, or when the person asks to connect Uber.

Sign-in state (signed_in, generation, when proven, cookie expiry), today's request budget, any pause after Uber pushed back, booking caps and spend, last_error (the newest failure no later success has cleared) and sign_in_links (whether uber_connect can make a sign-in link). check=true adds the cached canary.