{"service":"Hilo Travel","description":"Travel capabilities for AI agents: search hotels worldwide, check live availability and prices, lock an offer, book, and manage or cancel reservations — plus real-time booking notifications (confirmations, hotel confirmation numbers, check-in instructions). International flight search across 180+ airlines with direct booking links. Train availability in Spain via Trenes.com, fare selection and passenger prefill through to the payment page. Built and operated by Hilo.","getYourAgent":{"url":"https://hilo.cx","text":"Get your own AI agent with travel capabilities"},"auth":"Authorization: Bearer <your Hilo Travel API key>","docs":{"openapi":"https://travel-api.hilo.cx/openapi.json","llms":"https://travel-api.hilo.cx/llms.txt","mcp":"https://travel-api.hilo.cx/mcp"},"web":{"home":"https://travel-api.hilo.cx","bookings":"https://travel-api.hilo.cx/bookings"},"flow":["GET /v1/places?q=","POST /v1/hotels/search","POST /v1/prebook","POST /v1/bookings | POST /v1/payment-links","GET /v1/notifications"],"trains":["POST /v1/trains/searches","POST /v1/trains/searches/:searchId/returns","POST /v1/trains/searches/:searchId/checkout → checkoutUrl","GET /v1/trains/searches/:searchId"],"flights":["GET /v1/flights/locations?q=","GET /v1/flights/explore","GET /v1/flights/explore-destination","GET /v1/flights/search","GET /v1/flights/calendar","GET /v1/flights/deals"],"version":"0.1.0","endpoints":{"GET /v1/me":"who am I, account mode (sandbox|production)","GET /v1/places?q=":"place search (cities, areas) → placeId","GET /v1/hotels?placeId=|countryCode=&cityName=":"hotel directory (no prices)","GET /v1/hotels/:id":"hotel details (photos, rooms, policies, check-in times)","GET /v1/hotels/:id/reviews":"guest reviews","POST /v1/hotels/search":"availability + prices","GET /v1/flights/search":"Search dated flights or retrieve return/booking options with continuation tokens. Set flight_type explicitly. Missing destinations/dates need clarification; use explore for flexible trips.","GET /v1/flights/explore":"Discover destinations with only departure_id; dates and destination are optional. Returns kgmid identifiers for explore-destination.","GET /v1/flights/explore-destination":"Get detailed flight options for an explored destination. Pass its exact kgmid as arrival_id; dates can remain flexible.","GET /v1/flights/calendar":"Compare route prices over date ranges. Requires route and outbound_date; round trips also need return_date.","GET /v1/flights/locations":"Resolve partial city or airport text with q into IATA codes and kgmid identifiers. Inspect candidates before choosing. Supports hl only.","GET /v1/flights/deals":"Find deals with only departure_id, optionally q for destination preferences OR filters. Destinations and dates are returned, not requested.","GET /v1/trains/stations?q=":"Spain: city/station suggestions from Trenes.com","POST /v1/trains/searches":"Spain: live train fares and passenger slots","POST /v1/trains/searches/:searchId/returns":"compatible return fares for the selected outbound","POST /v1/trains/searches/:searchId/checkout":"prefill passengers → Trenes.com payment page; no payment submitted","GET /v1/trains/searches/:searchId":"session progress or saved checkout link; not payment confirmation","POST /v1/prebook":"lock an offer → prebookId, final price, cancellation terms","POST /v1/bookings":"disabled: 402 traveler_payment_required; use /v1/payment-links","POST /v1/payment-links":"traveler pays: hosted payment url; booking completes on payment","GET /v1/bookings":"your bookings","GET /v1/bookings/:id":"live status","POST /v1/bookings/:id/cancellation-quote":"what cancelling costs + the disclaimer to confirm","DELETE /v1/bookings/:id":"cancel (quote + confirm; every step logged as evidence)","PATCH /v1/bookings/:id":"amend the booking holder","POST /v1/bookings/:id/reschedule/options":"disabled until traveler-paid price differences are supported","POST /v1/bookings/:id/reschedule":"disabled: 409 reschedule_unavailable","GET /v1/bookings/:id/audit":"tamper-evident log of every management action","POST /v1/whitelabel/sso":"one-time sign-in link into the Hilo travel microsite","GET /v1/notifications":"booking lifecycle events","GET|POST|DELETE /v1/subscriptions":"your own webhook endpoints for those events","GET /v1/deliveries":"webhook delivery log","GET|POST|DELETE /v1/keys":"API keys (dashboard users only)","PATCH /v1/account":"mode / payment method / defaults (dashboard users only)","GET /v1/events":"audit trail","GET /bookings (web)":"signed-in travelers: bookings, vouchers, check-in details"}}