Booking File History API Reference
|
GET |
book/reservation/bookingfilehistory/{Identifier} Where {Identifier} is the value to retrieve the booking file. The identifier type is specified in the query parameter. Base path: The base path for this API varies from that for other TripServices Flights APIs and does not include air at the end.
Pre-production https://api.pp.travelport.net/11/ Production https://api.travelport.net/11/ |
Related Content: Booking Guide
Booking File History returns the history of the booking file, which is a chronological record of changes made by the agency and vendor. History lets you investigate booking issues, understand who made specific changes, track airline schedule changes, and verify ticketing activities.
At this time, the response cannot be filtered. All changes made to the booking file are returned.
Request
As part of the request requirements, also see Authentication and Common Flights API Headers.
Query Parameters
| Parameter | Description | Required/Optional |
|---|---|---|
|
identifierType |
Specifies the type of identifier sent in the request. Supported value:
|
Required |
Request Body
No message payload.
Response
Show Response Body Table - Booking File History objects
|
Object |
Description |
|---|---|
|
BookingFileHistoryResponse |
Top-level object for history details. Includes the locator and historyEvent objects. Key value pairs:
The objects and data returned in a history response vary according to the information present in the booking file. |
|
locator |
Includes the identifier used in the request, the creation date, and the last updated date and time. Key value pairs:
|
|
historyEvent |
Wrapper for all changes being returned. A key value pair before the block of information indicates when the change was made and by whom. The most recent change is listed first. Key value pairs:
Objects within historyEvent depend on the type of information in the booking file.
Within each object, the action key value pair identifies the type of change. Possible values are Added, Modified, Deleted. |
Example Request
No message payload.
Example Response
The objects and data returned in a booking file history response vary according to the information present in the booking file.
Show example booking file history
{
"BookingFileHistoryResponse": {
"locator": {
"value": "JJ2D27",
"locatorType": "Locator",
"source": "1G",
"creationDate": "2026-11-06",
"lastUpdated": "2026-11-06T21:32:43.000Z"
},
"createDateTime": "2026-11-06T21:26:00.000Z",
"creatorReceivedFrom": "TP/C838261",
"historyEvent": [
{
"eventDateTime": "2026-11-06T21:32:00.000Z",
"eventReceivedFrom": "JA/C838261",
"hotels": [
{
"action": "Added",
"hotelSegmentInformation": {
"chainCode": "ES",
"location": "DEN",
"segmentStatusCode": "SS",
"quantity": 1,
"arrivalDate": "2027-01-19",
"departureDate": "2027-01-17",
"numberOfNights": 2,
"propertyCode": "52557",
"propertyName": "ES DENVER INTL AIRP",
"roomType": "A0Z",
"rate": {
"value": 189,
"code": "USD",
"minorUnit": 2
},
"agencyCodeIATA": "02345243",
"guarantee": "XXXX",
"guestName": {
"@type": "PersonName",
"Given": "SMITH JAMES"
}
}
}
]
},
{
"eventDateTime": "2026-11-06T21:30:00.000Z",
"eventReceivedFrom": "J/C838261",
"cars": [
{
"action": "Added",
"carSegmentInformation": {
"vendorCode": "AL",
"location": "DEN",
"segmentStatusCode": "SS",
"quantity": 1,
"pickUpDate": "2027-01-17",
"pickUpLocationCode": "DENT71",
"pickUpTime": "0955",
"dropOffDate": "2027-01-19",
"dropOffTime": "0940",
"vehicleType": "CCAR",
"rate:": {
"value": 43.22,
"code": "USD",
"minorUnit": 2
},
"rateDescription": "USD43.22DY-UNL FM",
"agencyCodeIATA": "02345243",
"guarantee": "XXXX"
}
}
]
},
{
"eventDateTime": "2026-11-06T21:27:00.000Z",
"filedFares": [
{
"action": "Deleted",
"name": {
"@type": "PersonName",
"Given": "SMITH JAMES"
},
"passengerTypeCode": "ADT",
"totalPrice": {
"value": 496.8,
"code": "USD",
"minorUnit": 2
},
"creationDate": "2026-11-06"
},
{
"action": "Deleted",
"name": {
"@type": "PersonName",
"Given": "SMITH JAMES"
},
"passengerTypeCode": "ADT",
"totalPrice": {
"value": 496.8,
"code": "USD",
"minorUnit": 2
},
"creationDate": "2026-11-06"
}
]
},
{
"eventDateTime": "2026-11-06T21:27:00.000Z",
"eventReceivedFrom": "JA/C838261",
"flights": [
{
"action": "Deleted",
"flightSegmentInformation": {
"carrier": "UA",
"flightNumber": "2814",
"classOfService": "Y",
"departureDate": "2027-01-17",
"departureTime": "0700",
"arrivalDate": "2027-01-17",
"arrivalTime": "0955",
"from": "BOS",
"to": "DEN",
"segmentStatusCode": "HK",
"quantity": 1
}
},
{
"action": "Deleted",
"flightSegmentInformation": {
"carrier": "UA",
"flightNumber": "1232",
"classOfService": "Y",
"departureDate": "2027-01-19",
"departureTime": "0940",
"arrivalDate": "2027-01-19",
"arrivalTime": "1539",
"from": "DEN",
"to": "BOS",
"segmentStatusCode": "HK",
"quantity": 1
}
},
{
"action": "Added",
"flightSegmentInformation": {
"carrier": "UA",
"flightNumber": "2814",
"classOfService": "T",
"departureDate": "2027-01-17",
"departureTime": "0700",
"arrivalDate": "2027-01-17",
"arrivalTime": "0955",
"from": "BOS",
"to": "DEN",
"segmentStatusCode": "HS",
"quantity": 1
}
},
{
"action": "Added",
"flightSegmentInformation": {
"carrier": "UA",
"flightNumber": "1232",
"classOfService": "L",
"departureDate": "2027-01-19",
"departureTime": "0940",
"arrivalDate": "2027-01-19",
"arrivalTime": "1539",
"from": "DEN",
"to": "BOS",
"segmentStatusCode": "HS",
"quantity": 1
}
}
]
},
{
"eventDateTime": "2026-11-06T21:26:00.000Z",
"eventReceivedFrom": "TP/C838261",
"flights": [
{
"action": "Added",
"flightSegmentInformation": {
"carrier": "UA",
"flightNumber": "2814",
"classOfService": "Y",
"departureDate": "2027-01-17",
"departureTime": "0700",
"arrivalDate": "2027-01-17",
"arrivalTime": "0955",
"from": "BOS",
"to": "DEN",
"segmentStatusCode": "HS",
"quantity": 1
}
},
{
"action": "Added",
"flightSegmentInformation": {
"carrier": "UA",
"flightNumber": "1232",
"classOfService": "Y",
"departureDate": "2027-01-19",
"departureTime": "0940",
"arrivalDate": "2027-01-19",
"arrivalTime": "1539",
"from": "DEN",
"to": "BOS",
"segmentStatusCode": "HS",
"quantity": 1
}
}
]
}
],
"Result": {
"@type": "Result",
"status": "Complete"
}
}
}{
"BookingFileHistoryResponse": {
"locator": {
"value": "H9DVSM",
"locatorType": "Locator",
"source": "1G",
"creationDate": "2026-06-29",
"lastUpdated": "2026-09-01T00:45:41.000Z"
},
"createDateTime": "2026-06-29T06:44:00.000Z",
"creatorReceivedFrom": "DD/0511431",
"historyEvent": [
{
"eventDateTime": "2026-09-01T00:45:00.000Z",
"eventReceivedFrom": "CLTYSUA01SEP/0045",
"flights": [
{
"action": "Added",
"flightSegmentInformation": {
"carrier": "UA",
"flightNumber": "546",
"classOfService": "U",
"departureDate": "2026-12-21",
"departureTime": "1532",
"arrivalDate": "2026-12-21",
"arrivalTime": "1700",
"from": "BOS",
"to": "EWR",
"segmentStatusCode": "TK",
"quantity": 1
}
}
]
},
{
"eventDateTime": "2026-07-23T22:54:00.000Z",
"eventReceivedFrom": "HDQRMUA23JUL/2254",
"flights": [
{
"action": "Modified",
"flightSegmentInformation": {
"carrier": "UA",
"flightNumber": "546",
"classOfService": "U",
"departureDate": "2026-12-21",
"departureTime": "1541",
"arrivalDate": "2026-12-21",
"arrivalTime": "1707",
"from": "BOS",
"to": "EWR",
"segmentStatusCode": "UN",
"quantity": 1
}
},
{
"action": "Added",
"flightSegmentInformation": {
"carrier": "UA",
"flightNumber": "1551",
"classOfService": "U",
"departureDate": "2026-12-21",
"departureTime": "1533",
"arrivalDate": "2026-12-21",
"arrivalTime": "1659",
"from": "BOS",
"to": "EWR",
"segmentStatusCode": "TK",
"quantity": 1
}
}
]
},
{
"eventDateTime": "2026-07-09T23:26:00.000Z",
"eventReceivedFrom": "HDQRMUA09JUL/2326",
"flights": [
{
"action": "Modified",
"flightSegmentInformation": {
"carrier": "UA",
"flightNumber": "546",
"classOfService": "U",
"departureDate": "2026-12-21",
"departureTime": "1541",
"arrivalDate": "2026-12-21",
"arrivalTime": "1707",
"from": "BOS",
"to": "EWR",
"segmentStatusCode": "TK",
"quantity": 1
}
}
],
"filedFares": [
{
"action": "Deleted",
"name": {
"@type": "PersonName",
"Given": "JOFFE SAMUEL MR"
},
"passengerTypeCode": "ADT",
"totalPrice": {
"value": 43302.8,
"code": "ZAR",
"minorUnit": 2
},
"creationDate": "2026-06-29",
"fareCalculation": {
"fareCalculationString": "JNB UA X/EWR UA BOS 650.00 UA X/EWR UA JNB 1320.00 NUC1970.00END ROE1.0",
"rateOfExchange": 1
},
"filedFareSegment": [
{
"segmentNumber": 1,
"fareBasisCode": "VX0XKYNC",
"baggage": {
"quantity": 1,
"soldByPieceInd": true
},
"ValidDateRange": {
"start": "2026-08-26",
"end": "2026-08-26"
}
},
{
"segmentNumber": 2,
"fareBasisCode": "VX0XKYNC",
"baggage": {
"quantity": 1,
"soldByPieceInd": true
},
"ValidDateRange": {
"start": "2026-08-27",
"end": "2026-08-27"
}
},
{
"segmentNumber": 3,
"fareBasisCode": "UX0XKYNC",
"baggage": {
"quantity": 1,
"soldByPieceInd": true
},
"ValidDateRange": {
"start": "2026-12-21",
"end": "2026-12-21"
}
},
{
"segmentNumber": 4,
"fareBasisCode": "UX0XKYNC",
"baggage": {
"quantity": 1,
"soldByPieceInd": true
},
"ValidDateRange": {
"start": "2026-12-21",
"end": "2026-12-21"
}
}
],
"validatingAirline": "UA"
}
]
},
{
"eventDateTime": "2026-06-29T19:56:00.000Z",
"filedFares": [
{
"action": "Deleted",
"name": {
"@type": "PersonName",
"Given": "JOFFE SAMUEL MR"
},
"passengerTypeCode": "ADT",
"totalPrice": {
"value": 43302.8,
"code": "ZAR",
"minorUnit": 2
},
"creationDate": "2026-06-29"
},
{
"action": "Deleted",
"name": {
"@type": "PersonName",
"Given": "JOFFE SAMUEL MR"
},
"passengerTypeCode": "ADT",
"totalPrice": {
"value": 43302.8,
"code": "ZAR",
"minorUnit": 2
},
"creationDate": "2026-06-29"
},
{
"action": "Deleted",
"name": {
"@type": "PersonName",
"Given": "JOFFE SAMUEL MR"
},
"passengerTypeCode": "ADT",
"totalPrice": {
"value": 43302.8,
"code": "ZAR",
"minorUnit": 2
},
"creationDate": "2026-06-29"
},
{
"action": "Deleted",
"name": {
"@type": "PersonName",
"Given": "JOFFE SAMUEL MR"
},
"passengerTypeCode": "ADT",
"totalPrice": {
"value": 43302.8,
"code": "ZAR",
"minorUnit": 2
},
"creationDate": "2026-06-29"
}
]
},
{
"eventDateTime": "2026-06-29T06:44:00.000Z",
"eventReceivedFrom": "DD/0511431",
"flights": [
{
"action": "Added",
"flightSegmentInformation": {
"carrier": "UA",
"flightNumber": "187",
"classOfService": "V",
"departureDate": "2026-08-26",
"departureTime": "2200",
"arrivalDate": "2026-08-27",
"arrivalTime": "0735",
"from": "JNB",
"to": "EWR",
"segmentStatusCode": "HS",
"quantity": 1
}
},
{
"action": "Added",
"flightSegmentInformation": {
"carrier": "UA",
"flightNumber": "1669",
"classOfService": "V",
"departureDate": "2026-08-27",
"departureTime": "1129",
"arrivalDate": "2026-08-27",
"arrivalTime": "1247",
"from": "EWR",
"to": "BOS",
"segmentStatusCode": "HS",
"quantity": 1
}
},
{
"action": "Added",
"flightSegmentInformation": {
"carrier": "UA",
"flightNumber": "546",
"classOfService": "U",
"departureDate": "2026-12-21",
"departureTime": "1630",
"arrivalDate": "2026-12-21",
"arrivalTime": "1755",
"from": "BOS",
"to": "EWR",
"segmentStatusCode": "HS",
"quantity": 1
}
},
{
"action": "Added",
"flightSegmentInformation": {
"carrier": "UA",
"flightNumber": "188",
"classOfService": "U",
"departureDate": "2026-12-21",
"departureTime": "2050",
"arrivalDate": "2026-12-22",
"arrivalTime": "1835",
"from": "EWR",
"to": "JNB",
"segmentStatusCode": "HS",
"quantity": 1
}
}
]
}
],
"Result": {
"@type": "Result",
"status": "Complete"
}
}
}