Overview
The booking API for Haramain High-Speed Railway, for Online Travel Agencies
The HHR Ticketing System OTA API lets Online Travel Agencies search, book, pay for, and cancel journeys on Saudi Arabia Railway’s Haramain High-Speed Railway (HHR). It follows the OpenTravel Alliance (OTA) standard, adapted to JSON.
You reach the railway through WorldTicket (GO7). Indra EBKS is the core booking system, GO7 is the OTA-standard layer on top of it, and you integrate with GO7. Everything in this reference is live in production.
The GO7 documentation is the production source of truth. For anything this site does not cover, follow the GO7 OTA API docs. The Changelog lists the GO7 updates this site has absorbed.
How the API is shaped
Every operation is a single HTTP POST to one OTA endpoint. You choose the operation with the local-name header. The request and response bodies change per operation, but the URL and the method never do.
The operations
Two small REST services sit beside the OTA endpoint. They use plain GET and POST calls with no local-name header. The schedule service lists the routes on sale and the dates that have trains. The ticket service resends the confirmation emails and serves the ticket PDFs. See Routes and calendar and Ticket documents.
A typical journey runs in order: search for a train, create the booking, pay and issue the tickets. See Booking flows for the full sequence and Booking models to choose between individual and group. When a call fails, Errors explains what came back.
Environments
Build against Test first, then switch the base URL for Production. See Authentication for how to get a key or a token.
Stations
Codes you will use
Booking class. Y is Economy (HHR class T). C is Business (HHR class P).
Passenger type. ADT, CHD, and INF map to HHR codes 1, 2, and 3.
Document type. 2 is a passport. 5 is a national ID.
Record locators
A booking carries two locators. The W1 locator is the WorldTicket PNR, and you use it in every API call. The HHR locator is the railway’s own reference. Read either one back from the booking.
Resources
GO7 publishes two downloads that pair with this reference:
- Postman collection. Set the
apiKey,agent_id,agent_name, andtenantvariables before you run it. - OTA 2015B XML schema. The JSON bodies in this reference follow these element names.

