# SAR - Harmain Train | Documentation

## Instructions for AI Agents

- For clean Markdown of any page, append `.md` to the page URL
- For section-specific indexes, append `/llms.txt` to any section URL
- For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://wt.hhr.systems/_mcp/server

## Docs

- [Overview](https://wt.hhr.systems/overview.md): The booking API for Haramain High-Speed Railway, for Online Travel Agencies
- [Authentication](https://wt.hhr.systems/authentication.md): Sign every request with an API key or a JWT
- [Routes and calendar](https://wt.hhr.systems/routes-and-calendar.md): List the city pairs on sale and the dates that have trains
- [Booking models](https://wt.hhr.systems/booking-models.md): Book by name, or hold seats and add names later
- [Booking flows](https://wt.hhr.systems/booking-flows.md): From a search to tickets in hand
- [Updating passengers](https://wt.hhr.systems/updating-passengers.md): Add or change passenger details on an existing booking
- [Seat maps](https://wt.hhr.systems/seat-maps.md): Show the seat layout and move passengers to the seats they want
- [Paying with the wallet](https://wt.hhr.systems/paying-with-the-wallet.md): Fund a debit account and draw from it when you ticket
- [Time limits](https://wt.hhr.systems/time-limits.md): Read the deadlines off the booking and act before them
- [Cancelling](https://wt.hhr.systems/cancelling.md): Cancel a whole booking in one call
- [Ticket documents](https://wt.hhr.systems/tickets.md): Resend the confirmation emails and download the tickets
- [Errors](https://wt.hhr.systems/errors.md): What a failed request returns and how to read it
- [Changelog](https://wt.hhr.systems/changelog.md): GO7 updates this site has absorbed, newest first

## API Docs

- HHR Ticketing System API > Search [Search trains and fares](https://wt.hhr.systems/hhr-ticketing-system-api/search/low-fare-search.md)
- HHR Ticketing System API > Booking [Create an individual booking](https://wt.hhr.systems/hhr-ticketing-system-api/booking/create-individual.md)
- HHR Ticketing System API > Booking [Create a group booking](https://wt.hhr.systems/hhr-ticketing-system-api/booking/create-group.md)
- HHR Ticketing System API > Booking [Update passengers on a booking](https://wt.hhr.systems/hhr-ticketing-system-api/booking/update-passengers.md)
- HHR Ticketing System API > Ticketing [Pay and issue tickets](https://wt.hhr.systems/hhr-ticketing-system-api/ticketing/issue-tickets.md)
- HHR Ticketing System API > Manage [Read a booking](https://wt.hhr.systems/hhr-ticketing-system-api/manage/read.md)
- HHR Ticketing System API > Manage [Cancel a booking](https://wt.hhr.systems/hhr-ticketing-system-api/manage/cancel.md)
- HHR Ticketing System API > Seats [Get the seat map](https://wt.hhr.systems/hhr-ticketing-system-api/seats/map.md)
- HHR Ticketing System API > Tickets [Resend the ticket email](https://wt.hhr.systems/hhr-ticketing-system-api/tickets/resend-ticket-email.md)
- HHR Ticketing System API > Tickets [Resend the cancellation email](https://wt.hhr.systems/hhr-ticketing-system-api/tickets/resend-cancellation-email.md)
- HHR Ticketing System API > Tickets [Download all tickets](https://wt.hhr.systems/hhr-ticketing-system-api/tickets/download.md)
- HHR Ticketing System API > Tickets [Download one ticket](https://wt.hhr.systems/hhr-ticketing-system-api/tickets/download-passenger-segment.md)
- HHR Ticketing System API > Schedule [List the routes](https://wt.hhr.systems/hhr-ticketing-system-api/schedule/routes.md)
- HHR Ticketing System API > Schedule [List the dates with trains](https://wt.hhr.systems/hhr-ticketing-system-api/schedule/calendar.md)

## OpenAPI Specification

The raw OpenAPI 3.1 specification for this API is available at:
- [OpenAPI JSON](https://wt.hhr.systems/openapi.json)
- [OpenAPI YAML](https://wt.hhr.systems/openapi.yaml)