{"openapi":"3.0.3","info":{"title":"Hindukush Express Public Inventory API","version":"1.0.0","description":"Read-only inventory for AI assistants and integrators. Use this to discover cities, routes, departures, and seat availability. Passengers must complete booking on the website \u2014 this API cannot hold seats, take payment, or create bookings. Discovery: \/llms.txt, \/.well-known\/llm-context, \/.well-known\/api-catalog."},"servers":[{"url":"https:\/\/hindukush.express\/api\/v1\/public"}],"paths":{"\/cities":{"get":{"summary":"List active cities","parameters":[{"name":"locale","in":"query","required":false,"schema":{"type":"string"},"description":"UI locale for city names and money formatting (must be an enabled site language)."}],"responses":{"200":{"description":"City list"}}}},"\/routes":{"get":{"summary":"List active origin\u2192destination routes","parameters":[{"name":"locale","in":"query","required":false,"schema":{"type":"string"},"description":"UI locale for city names and money formatting (must be an enabled site language)."}],"responses":{"200":{"description":"Route list"}}}},"\/departures":{"get":{"summary":"List upcoming departures, or search one route and date","description":"With no query parameters, returns scheduled departures for the next 7 days. With origin_city_id, destination_city_id, and date=YYYY-MM-DD, returns that search.","parameters":[{"name":"locale","in":"query","required":false,"schema":{"type":"string"},"description":"UI locale for city names and money formatting (must be an enabled site language)."},{"name":"origin_city_id","in":"query","required":false,"schema":{"type":"integer"}},{"name":"destination_city_id","in":"query","required":false,"schema":{"type":"integer"}},{"name":"date","in":"query","required":false,"schema":{"type":"string","format":"date"}}],"responses":{"200":{"description":"Departure list with fares and seats_available"}}}},"\/departures\/{id}\/availability":{"get":{"summary":"Seat availability for one departure (no passenger PII)","parameters":[{"name":"locale","in":"query","required":false,"schema":{"type":"string"},"description":"UI locale for city names and money formatting (must be an enabled site language)."},{"name":"id","in":"path","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"description":"Per-seat available|unavailable map"}}}}},"externalDocs":{"description":"Human booking UI","url":"https:\/\/hindukush.express\/en\/book"}}