> For clean Markdown of any page, append .md to the page URL. > For a complete documentation index, see https://wt.hhr.systems/llms.txt. > For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://wt.hhr.systems/_mcp/server. # Read a booking POST https://api.sar.worldticket.cloud/ota/v2015b/OTA#OTA_ReadRQ Content-Type: application/json Read a booking by its W1 record locator. Send the locator in `readRequest.uniqueID` with `type` `14`. Use this to check the current status and the time limits before you ticket or cancel. Reference: https://wt.hhr.systems/hhr-ticketing-system-api/manage/read ## OpenAPI Specification ```yaml openapi: 3.1.0 info: title: collection version: 1.0.0 paths: /ota/v2015b/OTA#OTA_ReadRQ: post: operationId: read summary: Read a booking description: > Read a booking by its W1 record locator. Send the locator in `readRequest.uniqueID` with `type` `14`. Use this to check the current status and the time limits before you ticket or cancel. tags: - Manage parameters: - name: x-api-key in: header required: true schema: type: string - name: local-name in: header description: Routes the request to the read operation. required: true schema: $ref: '#/components/schemas/OtaV2015BOtaOtaReadRqPostParametersLocalName' responses: '200': description: The full reservation. content: application/json: schema: $ref: '#/components/schemas/ReadResponse' requestBody: content: application/json: schema: $ref: '#/components/schemas/ReadRequest' servers: - url: https://api.sar.worldticket.cloud description: Production - url: https://test-api.worldticket.net description: Test components: schemas: OtaV2015BOtaOtaReadRqPostParametersLocalName: type: string enum: - OTA_ReadRQ default: OTA_ReadRQ title: OtaV2015BOtaOtaReadRqPostParametersLocalName RequestorID: type: object properties: id: type: string description: Agent identifier. name: type: string description: Agency name. type: type: string description: Requestor type. title: RequestorID BookingChannel: type: object properties: type: type: string title: BookingChannel Source: type: object properties: isocurrency: type: string description: ISO currency code. Always SAR. isoCurrency: type: string description: ISO currency code (used by the cancel operation). requestorID: $ref: '#/components/schemas/RequestorID' bookingChannel: $ref: '#/components/schemas/BookingChannel' title: Source Pos: type: object properties: source: type: array items: $ref: '#/components/schemas/Source' description: Point of sale. Identifies the agent and channel behind the request. title: Pos UniqueIdType: type: string enum: - '14' description: Identifier type. 14 is a record locator. title: UniqueIdType UniqueID: type: object properties: id: type: string description: Record locator. type: $ref: '#/components/schemas/UniqueIdType' description: Identifier type. 14 is a record locator. title: UniqueID ReadRequestReadRequestsReadRequestItems: type: object properties: uniqueID: $ref: '#/components/schemas/UniqueID' title: ReadRequestReadRequestsReadRequestItems ReadRequestReadRequests: type: object properties: readRequest: type: array items: $ref: '#/components/schemas/ReadRequestReadRequestsReadRequestItems' title: ReadRequestReadRequests ReadRequest: type: object properties: pos: $ref: '#/components/schemas/Pos' version: type: string readRequests: $ref: '#/components/schemas/ReadRequestReadRequests' required: - pos - version - readRequests title: ReadRequest ReadResponseSuccess: type: object properties: {} title: ReadResponseSuccess ReadResponse: type: object properties: success: $ref: '#/components/schemas/ReadResponseSuccess' airReservation: type: object additionalProperties: description: Any type timeStamp: type: string version: type: number format: double title: ReadResponse ``` ## Examples **Request** ```json { "pos": { "source": [ { "isocurrency": "SAR", "requestorID": { "id": "AGENT001", "name": "Sample Travel", "type": "5" }, "bookingChannel": { "type": "OTA" } } ] }, "version": "2.001", "readRequests": { "readRequest": [ { "uniqueID": { "id": "N6G2NW", "type": "14" } } ] } } ``` **Response** ```json { "success": {}, "airReservation": { "airItinerary": { "originDestinationOptions": { "originDestinationOption": [ { "flightSegment": [ { "arrivalAirport": { "locationCode": "MKX" }, "arrivalDateTime": "2026-05-20T17:55:00.000+03:00", "departureAirport": { "locationCode": "JXD" }, "departureDateTime": "2026-05-20T17:21:00.000+03:00", "flightNumber": "0141", "marketingAirline": { "code": "HHR" }, "resBookDesigCode": "Y", "rph": "1" } ] } ] } }, "bookingReferenceID": [ { "companyName": { "code": "W1" }, "id": "N6G2NW", "type": "14" }, { "companyName": { "code": "HHR" }, "id": "CB0255134", "type": "14" } ], "offer": { "status": "BOOKED" }, "priceInfo": { "fareInfos": { "fareInfo": [ { "ruleInfo": { "tpaextensions": { "confirmationTimeLimit": "2026-05-17T10:49:00Z", "updateTravellersTimeLimit": "2026-05-17T10:20:00Z" } } } ] } }, "ticketing": [ { "flightSegmentRefNumber": [ "1" ], "ticketTimeLimit": "2026-05-17T14:03:09.000+03:00", "ticketType": "E_TICKET" } ] }, "timeStamp": "2026-05-01T09:40:19.220Z", "version": 2.001 } ``` **SDK Code** ```python import requests url = "https://api.sar.worldticket.cloud/ota/v2015b/OTA#OTA_ReadRQ" payload = { "pos": { "source": [ { "isocurrency": "SAR", "requestorID": { "id": "AGENT001", "name": "Sample Travel", "type": "5" }, "bookingChannel": { "type": "OTA" } } ] }, "version": "2.001", "readRequests": { "readRequest": [{ "uniqueID": { "id": "N6G2NW", "type": "14" } }] } } headers = { "local-name": "OTA_ReadRQ", "x-api-key": "YOUR_API_KEY", "Content-Type": "application/json" } response = requests.post(url, json=payload, headers=headers) print(response.json()) ``` ```javascript const url = 'https://api.sar.worldticket.cloud/ota/v2015b/OTA#OTA_ReadRQ'; const options = { method: 'POST', headers: { 'local-name': 'OTA_ReadRQ', 'x-api-key': 'YOUR_API_KEY', 'Content-Type': 'application/json' }, body: '{"pos":{"source":[{"isocurrency":"SAR","requestorID":{"id":"AGENT001","name":"Sample Travel","type":"5"},"bookingChannel":{"type":"OTA"}}]},"version":"2.001","readRequests":{"readRequest":[{"uniqueID":{"id":"N6G2NW","type":"14"}}]}}' }; try { const response = await fetch(url, options); const data = await response.json(); console.log(data); } catch (error) { console.error(error); } ``` ```go package main import ( "fmt" "strings" "net/http" "io" ) func main() { url := "https://api.sar.worldticket.cloud/ota/v2015b/OTA#OTA_ReadRQ" payload := strings.NewReader("{\n \"pos\": {\n \"source\": [\n {\n \"isocurrency\": \"SAR\",\n \"requestorID\": {\n \"id\": \"AGENT001\",\n \"name\": \"Sample Travel\",\n \"type\": \"5\"\n },\n \"bookingChannel\": {\n \"type\": \"OTA\"\n }\n }\n ]\n },\n \"version\": \"2.001\",\n \"readRequests\": {\n \"readRequest\": [\n {\n \"uniqueID\": {\n \"id\": \"N6G2NW\",\n \"type\": \"14\"\n }\n }\n ]\n }\n}") req, _ := http.NewRequest("POST", url, payload) req.Header.Add("local-name", "OTA_ReadRQ") req.Header.Add("x-api-key", "YOUR_API_KEY") req.Header.Add("Content-Type", "application/json") res, _ := http.DefaultClient.Do(req) defer res.Body.Close() body, _ := io.ReadAll(res.Body) fmt.Println(res) fmt.Println(string(body)) } ``` ```ruby require 'uri' require 'net/http' url = URI("https://api.sar.worldticket.cloud/ota/v2015b/OTA#OTA_ReadRQ") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true request = Net::HTTP::Post.new(url) request["local-name"] = 'OTA_ReadRQ' request["x-api-key"] = 'YOUR_API_KEY' request["Content-Type"] = 'application/json' request.body = "{\n \"pos\": {\n \"source\": [\n {\n \"isocurrency\": \"SAR\",\n \"requestorID\": {\n \"id\": \"AGENT001\",\n \"name\": \"Sample Travel\",\n \"type\": \"5\"\n },\n \"bookingChannel\": {\n \"type\": \"OTA\"\n }\n }\n ]\n },\n \"version\": \"2.001\",\n \"readRequests\": {\n \"readRequest\": [\n {\n \"uniqueID\": {\n \"id\": \"N6G2NW\",\n \"type\": \"14\"\n }\n }\n ]\n }\n}" response = http.request(request) puts response.read_body ``` ```java import com.mashape.unirest.http.HttpResponse; import com.mashape.unirest.http.Unirest; HttpResponse response = Unirest.post("https://api.sar.worldticket.cloud/ota/v2015b/OTA#OTA_ReadRQ") .header("local-name", "OTA_ReadRQ") .header("x-api-key", "YOUR_API_KEY") .header("Content-Type", "application/json") .body("{\n \"pos\": {\n \"source\": [\n {\n \"isocurrency\": \"SAR\",\n \"requestorID\": {\n \"id\": \"AGENT001\",\n \"name\": \"Sample Travel\",\n \"type\": \"5\"\n },\n \"bookingChannel\": {\n \"type\": \"OTA\"\n }\n }\n ]\n },\n \"version\": \"2.001\",\n \"readRequests\": {\n \"readRequest\": [\n {\n \"uniqueID\": {\n \"id\": \"N6G2NW\",\n \"type\": \"14\"\n }\n }\n ]\n }\n}") .asString(); ``` ```php request('POST', 'https://api.sar.worldticket.cloud/ota/v2015b/OTA#OTA_ReadRQ', [ 'body' => '{ "pos": { "source": [ { "isocurrency": "SAR", "requestorID": { "id": "AGENT001", "name": "Sample Travel", "type": "5" }, "bookingChannel": { "type": "OTA" } } ] }, "version": "2.001", "readRequests": { "readRequest": [ { "uniqueID": { "id": "N6G2NW", "type": "14" } } ] } }', 'headers' => [ 'Content-Type' => 'application/json', 'local-name' => 'OTA_ReadRQ', 'x-api-key' => 'YOUR_API_KEY', ], ]); echo $response->getBody(); ``` ```csharp using RestSharp; var client = new RestClient("https://api.sar.worldticket.cloud/ota/v2015b/OTA#OTA_ReadRQ"); var request = new RestRequest(Method.POST); request.AddHeader("local-name", "OTA_ReadRQ"); request.AddHeader("x-api-key", "YOUR_API_KEY"); request.AddHeader("Content-Type", "application/json"); request.AddParameter("application/json", "{\n \"pos\": {\n \"source\": [\n {\n \"isocurrency\": \"SAR\",\n \"requestorID\": {\n \"id\": \"AGENT001\",\n \"name\": \"Sample Travel\",\n \"type\": \"5\"\n },\n \"bookingChannel\": {\n \"type\": \"OTA\"\n }\n }\n ]\n },\n \"version\": \"2.001\",\n \"readRequests\": {\n \"readRequest\": [\n {\n \"uniqueID\": {\n \"id\": \"N6G2NW\",\n \"type\": \"14\"\n }\n }\n ]\n }\n}", ParameterType.RequestBody); IRestResponse response = client.Execute(request); ``` ```swift import Foundation let headers = [ "local-name": "OTA_ReadRQ", "x-api-key": "YOUR_API_KEY", "Content-Type": "application/json" ] let parameters = [ "pos": ["source": [ [ "isocurrency": "SAR", "requestorID": [ "id": "AGENT001", "name": "Sample Travel", "type": "5" ], "bookingChannel": ["type": "OTA"] ] ]], "version": "2.001", "readRequests": ["readRequest": [["uniqueID": [ "id": "N6G2NW", "type": "14" ]]]] ] as [String : Any] let postData = JSONSerialization.data(withJSONObject: parameters, options: []) let request = NSMutableURLRequest(url: NSURL(string: "https://api.sar.worldticket.cloud/ota/v2015b/OTA#OTA_ReadRQ")! as URL, cachePolicy: .useProtocolCachePolicy, timeoutInterval: 10.0) request.httpMethod = "POST" request.allHTTPHeaderFields = headers request.httpBody = postData as Data let session = URLSession.shared let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in if (error != nil) { print(error as Any) } else { let httpResponse = response as? HTTPURLResponse print(httpResponse) } }) dataTask.resume() ```