Skip to navigation

Updating passengers

Add or change passenger details on an existing booking
View as Markdown

OTA_AirBookModifyRQ changes passenger details on an existing booking. Its main job is completing a group booking: after you hold seats with OTA_AirPriceRQ, the booking has counts but no names, and you add the names and documents here before you pay and issue. It works on individual bookings too, so you can also use it to fix a detail on a booking you made by name.

Add group passengers before the deadline

For a group, add the passengers before the updateTravellersTimeLimit, and no later than 72 hours before departure. After that the booking is dead and you cannot ticket it. See Time limits.

Reference the booking

Point the request at the booking with its record locators in airReservation.bookingReferenceID: the W1 locator and the HHR locator. Then set modificationType in airBookModifyRQ for the kind of change you are making.

modificationTypeUse it to
3Add or change a passenger name
40Change other passenger details: gender, birth date, phone, email, address, or document
5Move a passenger to another seat, or add special services
9Change the contact details

Add the names

Send modificationType 3 with each traveler’s name and the segments they ride. Match travelerRefNumber.rph to the passenger slots the group booking created.

{
"version": "2.001",
"pos": {
"source": [
{
"isoCurrency": "SAR",
"requestorID": { "id": "AGENT001", "name": "Sample Travel", "type": "5" },
"bookingChannel": { "type": "OTA" }
}
]
},
"airReservation": {
"bookingReferenceID": [
{ "companyName": { "code": "W1" }, "type": "14", "id": "N6G2NW" },
{ "companyName": { "code": "HHR" }, "type": "14", "id": "CB0255134" }
]
},
"airBookModifyRQ": {
"modificationType": "3",
"travelerInfo": {
"airTraveler": [
{
"personName": { "givenName": ["BARAA"], "surname": "BUKHARI" },
"travelerRefNumber": { "rph": "1" },
"flightSegmentRPHs": { "flightSegmentRPH": ["1"] }
},
{
"personName": { "givenName": ["SARA"], "surname": "BUKHARI" },
"travelerRefNumber": { "rph": "2" },
"flightSegmentRPHs": { "flightSegmentRPH": ["1"] }
}
]
}
}
}

The response returns the reservation with the updated travelers. Once every passenger is in place, pay and issue.

Change other passenger details

Send modificationType 40 to change anything about a passenger except the name: gender, birth date, telephone, email, address, or the travel document. None of these affect the price. Point at the passenger with travelerRefNumber.rph and send the fields with their new values.

{
"version": "2.001",
"pos": {
"source": [
{
"isoCurrency": "SAR",
"requestorID": { "id": "AGENT001", "name": "Sample Travel", "type": "5" },
"bookingChannel": { "type": "OTA" }
}
]
},
"airReservation": {
"bookingReferenceID": [
{ "companyName": { "code": "W1" }, "type": "14", "id": "N6G2NW" },
{ "companyName": { "code": "HHR" }, "type": "14", "id": "CB0255134" }
]
},
"airBookModifyRQ": {
"modificationType": "40",
"travelerInfo": {
"airTraveler": [
{
"travelerRefNumber": { "rph": "1" },
"passengerTypeCode": "ADT",
"gender": "Male",
"personName": { "givenName": ["BARAA"], "surname": "BUKHARI" },
"telephone": [{ "countryAccessCode": "966", "phoneNumber": "512345678" }],
"email": [{ "value": "baraa@example.com" }],
"address": [{ "addressLine": ["Al Madinah Road, Jeddah"] }],
"document": [
{
"docID": "A12345678",
"docType": "2",
"docIssueCountry": "SA",
"docHolderNationality": "SA",
"birthDate": "1990-01-01",
"expireDate": "2031-12-31"
}
]
}
]
}
}
}

The response returns the traveler with the new details in airReservation.travelerInfo.

Before and after ticketing

Most changes happen before you ticket, while the booking is still open. Once the tickets are issued, what you can change narrows:

  • Names are fixed. A name change with modificationType 3 is refused after the tickets are issued, so get the names right before you pay.
  • Seats change after payment, and only then. A seat change with modificationType 5 needs a paid booking, must land before the updateTravellersTimeLimit, and cannot touch a segment that has departed or been cancelled. See Seat maps.
  • Every change has a deadline. Read updateTravellersTimeLimit off the booking and stop offering changes once it passes. Past it the API answers with code 150, “Changes are not permitted”.

For the exact bodies of other modification types, the GO7 modify-booking page is the source of truth. If a change is rejected, the error response tells you why.