Document History API Reference
|
POST |
document/documents/history Base path: Note the following base path does not include air and varies from other JSON APIs.
Pre-production https://api.pp.travelport.com/11/ Production https://api.travelport.com/11/ |
|
Get |
document/documentlist//{LocatorCode} Base path: Note the following base path does not include air and varies from other JSON APIs.
Pre-production https://api.pp.travelport.com/11/ Production https://api.travelport.com/11/ |
Related Content: Booking Guide
Send a Document List request to retrieve the history of any single document, such as a ticket, EMD, or MCO. Send a Document History request to return the history of all documents associated with a record locator. These requests retrieve this information even after the locator and ticket are purged from the airline's database. Returns the following information as applicable for each request:
-
Ticket issue history
-
Exchanges
-
Voids
-
Refund
-
Service fees
-
Invoices
-
Refunds
-
Cancellations
Request
Also see Authorization and Common Headers.
Query Parameters
None.
Request Body
The Document History request sends the locator code and retrieves all documents associated with that locator, including any and all tickets issued, MCOs, invoices, etc.
The Document List request sends a document number and returns the history of only that document (a ticket, EMD, or MCO), not any other documents associated with the locator code.
Show Request Body Table for Document List (request by record locator)
|
Object |
Description |
Required/Optional |
|---|---|---|
|
locator |
String. The record locator. Supports up to six record locators. |
Required |
Show Request Body Table for Document History (request by ticket number)
|
Object |
Description |
Required/Optional |
|---|---|---|
|
locator |
String. The record locator. |
Optional |
|
documentNumbers |
String with the document number. One number per request. Key value pairs:
|
Optional |
Response
Pending.
Show Response Body Table
|
Object |
Description |
|---|---|
Example Request
For additional examples and scenarios, download the developer toolkits and see Using Postman and Developer Toolkits.
Show Example Request by record locator
{
"locator": "BXVCNS"
}
{
"locator": "BXVCNS",
"documentNumbers": [
{
"number": "7959905312628",
"documentType": "TKT"
}
]
}
Example Response
For additional examples and scenarios, download the developer toolkits and see Using Postman and Developer Toolkits.
Show Example Document List response for record locator request
{
"DocumentHistoryResponse": {
"@type": "DocumentHistoryResponse",
"documentHistories": [
{
"number": {
"number": "7959905312628",
"numberOfConjunctiveTickets": 0,
"documentType": "TKT"
},
"issueDateTimeUTC": "2025-06-19T20:34:00.000Z",
"issuingGTID": "DFD708",
"issuingAgent": "27",
"issuingPseudoCityCode": "XB7",
"issuingIATA": "96120603",
"countryCode": "AU",
"travelportLocator": {
"value": "BXVCNS",
"locatorType": "GDS",
"source": "1G"
},
"supplierLocator": {
"value": "JWGLFY",
"source": "GDS"
},
"name": "GATER/ALLIE",
"pricingDateTimeUTC": "2025-06-19",
"pricingPseudoCityCode": "XB7",
"platingAirline": "VA",
"agentEnteredDetails": {
"fareQuoteModifierString": [
"/BFMU"
],
"ticketModifierString": [
"S1.2/ET/FS/CVA"
]
},
"formOfPayment": [
{
"formOfPaymentType": "CA",
"amount": 288
}
],
"ticketSegments": [
{
"sequence": 1,
"ClassOfService": "M",
"FareBasisCode": "TZLT0",
"Status": "Exchanged",
"Carrier": "VA",
"Number": "0901",
"Departure": {
"@type": "Departure",
"location": "SYD",
"date": "2025-07-01",
"time": "06:00:00"
},
"Arrival": {
"@type": "Arrival",
"location": "BNE"
},
"FlightStatusCode": "HK",
"ValidDateRange": {
"start": "2025-07-01",
"end": "2025-07-01"
},
"TicketBaggage": {
"quantity": 0,
"soldByPieceInd": true
},
"connectionInd": false
},
{
"sequence": 2,
"ClassOfService": "M",
"FareBasisCode": "UZLT0",
"Status": "Exchanged",
"Carrier": "VA",
"Number": "0912",
"Departure": {
"@type": "Departure",
"location": "BNE",
"date": "2025-07-23",
"time": "06:35:00"
},
"Arrival": {
"@type": "Arrival",
"location": "SYD"
},
"FlightStatusCode": "HK",
"ValidDateRange": {
"start": "2025-07-23",
"end": "2025-07-23"
},
"TicketBaggage": {
"quantity": 0,
"soldByPieceInd": true
},
"connectionInd": false
}
],
"documentDetail": {
"documentPricingDetail": {
"base": {
"value": 197.32,
"code": "AUD",
"minorUnit": 2
},
"totalDocumentPrice": {
"value": 288,
"code": "AUD",
"minorUnit": 2
},
"taxes": {
"@type": "TaxesDetail",
"TotalTaxes": 90.68,
"Tax": [
{
"value": 50.14,
"taxCode": "QR"
},
{
"value": 14.36,
"taxCode": "WG"
},
{
"value": 26.18,
"taxCode": "UO"
}
]
},
"fareCalculation": {
"fareCalculationString": "SYD VA BNE 118.66 VA SYD 78.66 AUD197.32END"
},
"commissionPercent": 0,
"restrictions": [
"RESTRICTIONS APPLY/NONEND",
"NONREF/",
"PENALTIES APPLY"
]
}
}
},
{
"number": {
"number": "7959905312629",
"numberOfConjunctiveTickets": 0,
"documentType": "TKT"
},
"issueDateTimeUTC": "2025-06-19T20:39:00.000Z",
"issuingGTID": "4A21FB",
"issuingAgent": "IF",
"issuingPseudoCityCode": "XB7",
"issuingIATA": "96120603",
"countryCode": "AU",
"travelportLocator": {
"value": "BXVCNS",
"locatorType": "GDS",
"source": "1G"
},
"supplierLocator": {
"value": "JWGLFY",
"source": "GDS"
},
"name": "GATER/ALLIE",
"pricingDateTimeUTC": "2025-06-19",
"pricingPseudoCityCode": "XB7",
"platingAirline": "VA",
"agentEnteredDetails": {
"ticketModifierString": [
"P01/S1.2/FEX7959905312628/CVA/1"
]
},
"formOfPayment": [
{
"formOfPaymentType": "CA",
"amount": 144.99
}
],
"ticketSegments": [
{
"sequence": 1,
"ClassOfService": "M",
"FareBasisCode": "NZLT0",
"Status": "OpenForUse",
"Carrier": "VA",
"Number": "0951",
"Departure": {
"@type": "Departure",
"location": "SYD",
"date": "2025-07-05",
"time": "15:00:00"
},
"Arrival": {
"@type": "Arrival",
"location": "BNE"
},
"FlightStatusCode": "HK",
"ValidDateRange": {
"start": "2025-07-05",
"end": "2025-07-05"
},
"TicketBaggage": {
"quantity": 0,
"soldByPieceInd": true
},
"connectionInd": false
},
{
"sequence": 2,
"ClassOfService": "M",
"FareBasisCode": "UZLT0",
"Status": "OpenForUse",
"Carrier": "VA",
"Number": "0912",
"Departure": {
"@type": "Departure",
"location": "BNE",
"date": "2025-07-23",
"time": "06:35:00"
},
"Arrival": {
"@type": "Arrival",
"location": "SYD"
},
"FlightStatusCode": "HK",
"ValidDateRange": {
"start": "2025-07-23",
"end": "2025-07-23"
},
"TicketBaggage": {
"quantity": 0,
"soldByPieceInd": true
},
"connectionInd": false
}
],
"documentDetail": {
"documentPricingDetail": {
"base": {
"value": 239.13,
"code": "AUD",
"minorUnit": 2
},
"totalDocumentPrice": {
"value": 342.31,
"code": "AUD",
"minorUnit": 2
},
"taxes": {
"@type": "TaxesDetail",
"TotalTaxes": 103.18,
"Tax": [
{
"value": 4.18,
"taxCode": "UO"
},
{
"value": 90,
"taxCode": "YR"
},
{
"value": 9,
"taxCode": "UO"
}
]
},
"fareCalculation": {
"fareCalculationString": "SYD VA BNE160.47VA SYD78.66AUD239.13END"
},
"commissionPercent": 0,
"restrictions": [
"* NONREF 239.13 AUD///PENALTIES APPLY/RESTRICTIONS APPLY/N"
]
}
},
"exchanges": {
"newPricingDetail": {
"base": {
"value": 239.13,
"code": "AUD",
"minorUnit": 2
},
"totalDocumentPrice": {
"value": 432.99,
"code": "AUD",
"minorUnit": 2
},
"totalFees": {
"value": 90,
"code": "AUD",
"minorUnit": 2
},
"totalAdditionalCollection": {
"value": 144.99
},
"taxes": {
"@type": "TaxesDetail",
"Tax": [
{
"value": 50.14,
"taxCode": "QR"
},
{
"value": 30.36,
"taxCode": "UO"
},
{
"value": 14.36,
"taxCode": "WG"
}
]
},
"paidTaxes": {
"@type": "TaxesDetail",
"Tax": [
{
"value": 50.14,
"taxCode": "QR"
},
{
"value": 26.18,
"taxCode": "UO"
},
{
"value": 14.36,
"taxCode": "WG"
}
]
},
"feeBreakdown": [
{
"atType": "Fee",
"@type": "Fee",
"description": "Change Fee",
"FeeAmountOrPercent": {
"@type": "FeeAmountOrPercentAmount",
"Amount": {
"value": 90,
"code": "AUD",
"minorUnit": 2
}
}
}
]
},
"originalIssue": {
"value": "7959905312628",
"issuingCity": "SYD",
"issueDate": "2025-06-20",
"agencyCodeIATA": "9612060",
"documentType": "TKT"
},
"previousIssue": [
{
"value": "7959905312628",
"documentType": "TKT"
}
]
}
},
{
"number": {
"number": "122484",
"documentType": "INV"
},
"issueDateTimeUTC": "2025-06-19T20:39:00.000Z",
"issuingGTID": "4A21FB",
"issuingAgent": "IF",
"issuingPseudoCityCode": "XB7",
"issuingIATA": "96120603",
"countryCode": "AU",
"travelportLocator": {
"value": "BXVCNS",
"locatorType": "GDS",
"source": "1G"
},
"supplierLocator": {
"value": "JWGLFY",
"source": "GDS"
},
"name": "GATER/ALLIE",
"pricingDateTimeUTC": "2025-06-19",
"pricingPseudoCityCode": "XB7",
"agentEnteredDetails": {
"ticketModifierString": [
"P01/S1.2/FEX7959905312628/CVA/1"
]
},
"formOfPayment": [
{
"formOfPaymentType": "CA",
"amount": 144.99
}
],
"ticketSegments": [
{
"sequence": 1,
"ClassOfService": "M",
"FareBasisCode": "NZLT0",
"Status": "OpenForUse",
"Carrier": "VA",
"Number": "0951",
"Departure": {
"@type": "Departure",
"location": "SYD",
"date": "2025-07-05",
"time": "15:00:00"
},
"Arrival": {
"@type": "Arrival",
"location": "BNE"
},
"FlightStatusCode": "HK",
"ValidDateRange": {
"start": "2025-07-05",
"end": "2025-07-05"
},
"TicketBaggage": {
"quantity": 0,
"soldByPieceInd": true
},
"connectionInd": false
},
{
"sequence": 2,
"ClassOfService": "M",
"FareBasisCode": "UZLT0",
"Status": "OpenForUse",
"Carrier": "VA",
"Number": "0912",
"Departure": {
"@type": "Departure",
"location": "BNE",
"date": "2025-07-23",
"time": "06:35:00"
},
"Arrival": {
"@type": "Arrival",
"location": "SYD"
},
"FlightStatusCode": "HK",
"ValidDateRange": {
"start": "2025-07-23",
"end": "2025-07-23"
},
"TicketBaggage": {
"quantity": 0,
"soldByPieceInd": true
},
"connectionInd": false
}
],
"documentDetail": {
"documentPricingDetail": {
"base": {
"value": 239.13,
"code": "AUD",
"minorUnit": 2
},
"totalDocumentPrice": {
"value": 342.31,
"code": "AUD",
"minorUnit": 2
},
"taxes": {
"@type": "TaxesDetail",
"TotalTaxes": 103.18,
"Tax": [
{
"value": 4.18,
"taxCode": "UO"
},
{
"value": 90,
"taxCode": "YR"
},
{
"value": 9,
"taxCode": "UO"
}
]
},
"fareCalculation": {
"fareCalculationString": "SYD VA BNE160.47VA SYD78.66AUD239.13END"
},
"commissionPercent": 0,
"restrictions": [
"* NONREF 239.13 AUD///PENALTIES APPLY/RESTRICTIONS APPLY/N"
]
}
},
"relatedDocument": {
"number": "7959905312629",
"documentType": "TKT"
},
"exchanges": {
"newPricingDetail": {
"base": {
"value": 239.13,
"code": "AUD",
"minorUnit": 2
},
"totalDocumentPrice": {
"value": 432.99,
"code": "AUD",
"minorUnit": 2
},
"totalFees": {
"value": 90,
"code": "AUD",
"minorUnit": 2
},
"totalAdditionalCollection": {
"value": 144.99
},
"taxes": {
"@type": "TaxesDetail",
"Tax": [
{
"value": 50.14,
"taxCode": "QR"
},
{
"value": 30.36,
"taxCode": "UO"
},
{
"value": 14.36,
"taxCode": "WG"
}
]
},
"paidTaxes": {
"@type": "TaxesDetail",
"Tax": [
{
"value": 50.14,
"taxCode": "QR"
},
{
"value": 26.18,
"taxCode": "UO"
},
{
"value": 14.36,
"taxCode": "WG"
}
]
},
"feeBreakdown": [
{
"atType": "Fee",
"@type": "Fee",
"description": "Change Fee",
"FeeAmountOrPercent": {
"@type": "FeeAmountOrPercentAmount",
"Amount": {
"value": 90,
"code": "AUD",
"minorUnit": 2
}
}
}
]
},
"originalIssue": {
"value": "7959905312628",
"issuingCity": "SYD",
"issueDate": "2025-06-20",
"agencyCodeIATA": "9612060",
"documentType": "TKT"
},
"previousIssue": [
{
"value": "7959905312628",
"documentType": "TKT"
}
]
}
}
]
}
}
"DocumentHistoryResponse": {
"@type": "DocumentHistoryResponse",
"documentHistories": [
{
"number": {
"number": "7959905312629",
"numberOfConjunctiveTickets": 0,
"documentType": "TKT"
},
"issueDateTimeUTC": "2025-06-19T20:39:00.000Z",
"issuingGTID": "4A21FB",
"issuingAgent": "IF",
"issuingPseudoCityCode": "XB7",
"issuingIATA": "96120603",
"countryCode": "AU",
"travelportLocator": {
"value": "BXVCNS",
"locatorType": "GDS",
"source": "1G"
},
"supplierLocator": {
"value": "JWGLFY",
"source": "GDS"
},
"name": "GATER/ALLIE",
"pricingDateTimeUTC": "2025-06-19",
"pricingPseudoCityCode": "XB7",
"platingAirline": "VA",
"agentEnteredDetails": {
"ticketModifierString": [
"P01/S1.2/FEX7959905312628/CVA/1"
]
},
"formOfPayment": [
{
"formOfPaymentType": "CA",
"amount": 144.99
}
],
"ticketSegments": [
{
"sequence": 1,
"ClassOfService": "M",
"FareBasisCode": "NZLT0",
"Status": "OpenForUse",
"Carrier": "VA",
"Number": "0951",
"Departure": {
"@type": "Departure",
"location": "SYD",
"date": "2025-07-05",
"time": "15:00:00"
},
"Arrival": {
"@type": "Arrival",
"location": "BNE"
},
"FlightStatusCode": "HK",
"ValidDateRange": {
"start": "2025-07-05",
"end": "2025-07-05"
},
"TicketBaggage": {
"quantity": 0,
"soldByPieceInd": true
},
"connectionInd": false
},
{
"sequence": 2,
"ClassOfService": "M",
"FareBasisCode": "UZLT0",
"Status": "OpenForUse",
"Carrier": "VA",
"Number": "0912",
"Departure": {
"@type": "Departure",
"location": "BNE",
"date": "2025-07-23",
"time": "06:35:00"
},
"Arrival": {
"@type": "Arrival",
"location": "SYD"
},
"FlightStatusCode": "HK",
"ValidDateRange": {
"start": "2025-07-23",
"end": "2025-07-23"
},
"TicketBaggage": {
"quantity": 0,
"soldByPieceInd": true
},
"connectionInd": false
}
],
"documentDetail": {
"documentPricingDetail": {
"base": {
"value": 239.13,
"code": "AUD",
"minorUnit": 2
},
"totalDocumentPrice": {
"value": 342.31,
"code": "AUD",
"minorUnit": 2
},
"taxes": {
"@type": "TaxesDetail",
"TotalTaxes": 103.18,
"Tax": [
{
"value": 4.18,
"taxCode": "UO"
},
{
"value": 90,
"taxCode": "YR"
},
{
"value": 9,
"taxCode": "UO"
}
]
},
"fareCalculation": {
"fareCalculationString": "SYD VA BNE160.47VA SYD78.66AUD239.13END"
},
"commissionPercent": 0,
"restrictions": [
"* NONREF 239.13 AUD///PENALTIES APPLY/RESTRICTIONS APPLY/N"
]
}
},
"exchanges": {
"newPricingDetail": {
"base": {
"value": 239.13,
"code": "AUD",
"minorUnit": 2
},
"totalDocumentPrice": {
"value": 432.99,
"code": "AUD",
"minorUnit": 2
},
"totalFees": {
"value": 90,
"code": "AUD",
"minorUnit": 2
},
"totalAdditionalCollection": {
"value": 144.99
},
"taxes": {
"@type": "TaxesDetail",
"Tax": [
{
"value": 50.14,
"taxCode": "QR"
},
{
"value": 30.36,
"taxCode": "UO"
},
{
"value": 14.36,
"taxCode": "WG"
}
]
},
"paidTaxes": {
"@type": "TaxesDetail",
"Tax": [
{
"value": 50.14,
"taxCode": "QR"
},
{
"value": 26.18,
"taxCode": "UO"
},
{
"value": 14.36,
"taxCode": "WG"
}
]
},
"feeBreakdown": [
{
"atType": "Fee",
"@type": "Fee",
"description": "Change Fee",
"FeeAmountOrPercent": {
"@type": "FeeAmountOrPercentAmount",
"Amount": {
"value": 90,
"code": "AUD",
"minorUnit": 2
}
}
}
]
},
"originalIssue": {
"value": "7959905312628",
"issuingCity": "SYD",
"issueDate": "2025-06-20",
"agencyCodeIATA": "9612060",
"documentType": "TKT"
},
"previousIssue": [
{
"value": "7959905312628",
"documentType": "TKT"
}
]
}
}
]
}
}