Skip to main content

Check Flight Tickets - Examples

Below are some common use cases on how to check flight tickets:

Check a single document

To ensure the successful check of the requested document, the request should contain:

  • Add tickets
    • number (13-digit electronic document number)
{
    "tickets": [
        {
            "number": "1607531707951"
        }
    ]
}

Check all documents of a booking

To ensure the successful check of the requested document, the request should contain:

  • Add confirmationId (PNR Locator or Sabre Order ID)
{
    "confirmationId": "ABCDEF"
}

Check two documents and change context

To ensure the successful check of the requested documents and to switch from the current Pseudo City Code (PCC) to the target PCC where the transaction should be executed, the request should contain:

  • Add tickets
    • number (13-digit electronic document number)
  • Add targetPcc (The PCC where the void transaction of the ticket should be executed)
{
    "targetPcc": "7KFA",
    "tickets": [
        {
            "number": "0143357868284"
        },
        {
            "number": "0143357868285"
        }
    ]
}

Check multiple documents and define refund qualifiers

To ensure the successful check of multiple documents, including refund qualifiers, the request should contain:

  • Add tickets
    • number (13-digit electronic document number)
  • Add refundQualifiers - for example:
    • waiverCode
    • overrideCancelFee
    • commissionAmount
{
    "tickets": [
        {
            "number": "6077531707952",
            "refundQualifiers": {
                "waiverCode": "ABCD1234",
                "commissionAmount": "25.00"
            }
        },
        {
            "number": "6077531707953",
            "refundQualifiers": {
                "overrideCancelFee": "0.00",
                "commissionAmount": "15.00"
            }
        }
    ]
}

Caution! By defining refund qualifiers, you'll override Sabre system pricing. Use this at your own risk.

Use Cases

The use cases below have been compiled to better illustrate the logical flow of Check Flight Ticket.

Use Case 1 - Check a single flight ticket

This use case is based on a reservation (PNR RECLOC: MSPKUK) for one traveler. The segment was booked as traditional Sabre air content:

*MSPKUK*IA«                                                     
 1 CX 652Y 10JUN Q SINHKG HK1  1255P  505P /DCCX*3EGJAB /E
 2 CX 735Y 15JUN T HKGSIN HK1   225P  625P /DCCX*3EGJAB /E

The ticket was issued without any additional documents:

*BYOKLY*T«                                                      
TKT/TIME LIMIT
  1.T-11FEB-G7RE*AWX
  2.TE 1607531707951-AT MILLE/M G7RE*AWX 0114/11FEB*   

The current ticket image indicates:

 ELECTRONIC TICKET RECORD                          CRS CODE:1536
INV:                  CUST:                          PNR:MSPKUK
TKT:1607531707951     ISSUED:11FEB21   PCC:G7RE   IATA:99999999
NAME:MILLER/MAX                                                
FORM OF PAYMENT                        FCI: 0                  
1    CASH                                                      
CPN  A/L  FLT  CLS DATE   BRDOFF  TIME  ST F/B             STAT
1    CX   652   Y  10JUN  SINHKG 1255P  OK YRZZSGAR        OPEN
                                NVB:10JUN   NVA:10JUN   BAG:30K
2    CX   735   Y  15JUN  HKGSIN  225P  OK YRZZSGAR        OPEN
                                NVB:15JUN   NVA:15JUN   BAG:30K

FARE     SGD1295.00                                            
TOTAL     USD1063.80     EQUIVALENT FARE PAID         USD975.00

In order to execute check flight ticket operation, determine the desired document number.

For example, the request to check the document could be:

{
    "tickets": [
        {
            "number": "1607531707951"
        }
    ]
}

The response does not contain errors:

{
    "request": {
        "tickets": [
            {
                "number": "1607531707951"
            }
        ]
    },
    "tickets": [
        {
            "number": "1607531707951",
            "isVoidable": true,
            "isRefundable": true,
            "refundTotals": {
                "subtotal": "885.00",
                "taxes": "88.80",
                "total": "973.80",
                "currencyCode": "USD"
            }
        }
    ]
}

In this case, the ticket meets the requirements for both options:

  • Void: ticket is within void period, coupons are all open
  • Refund: at least one coupon is open, carrier (CX - Cathay Pacific participates in Automated Refunds), system was able to price a refund

The reservation was not updated and the ticket remains untouched.

Use Case 2 - Check multiplke flight tickets and change context

This use case is based on a reservation (PNR RECLOC: KOEYRR) for two travelers. The segments were booked as traditional Sabre air content:

*KOEYRR*I*T«                                                 
1 AC 200Y 10SEP F YVRYYC HK2   600A  830A /DCAC*TQGZ47 /E
 2 AC 201Y 15SEP W YYCYVR HK2   630A  705A /DCAC*TQGZ47 /E
TKT/TIME LIMIT
  1.T-11FEB-7KFA*AWX
  2.TE 0143357868284-AT MEYER/C 7KFA*AWX 0729/11FEB*I
  3.TE 0143357868285-AT SCHUL/A 7KFA*AWX 0729/11FEB*I        

The ticket image of 0143357868284 indicates:

ELECTRONIC TICKET RECORD                          CRS CODE:1536
INV:                  CUST:                          PNR:KOEYRR
TKT:0143357868284     ISSUED:11FEB21   PCC:7KFA   IATA:99999999
NAME:MEYER/CAROL                                               
FORM OF PAYMENT                        FCI: 0                  
1    CASH                                                      
CPN  A/L  FLT  CLS DATE   BRDOFF  TIME  ST F/B             STAT
1    AC   200   Y  10SEP  YVRYYC  600A  OK Y0NAZALT        OPEN
                                NVB:        NVA:10SEP   BAG:2PC
2    AC   201   Y  15SEP  YYCYVR  630A  OK Y0NAZALT        OPEN
                                NVB:        NVA:10SEP   BAG:2PC

FARE     CAD1364.00                                            
TOTAL      GBP849.90     EQUIVALENT FARE PAID         GBP778.00   

To check both documents and change the context to the Pseudo City where they were issued, the request to Check Flight Ticket should be:

{
    "targetPcc": "7KFA",
    "tickets": [
        {
            "number": "0143357868284"
        },
        {
            "number": "0143357868285"
        }
    ]
}

No errors are returned in the response:

{
    "request": {
        "targetPcc": "7KFA",
        "tickets": [
            {
                "number": "0143357868284"
            },
            {
                "number": "0143357868285"
            }
        ]
    },
    "tickets": [
        {
            "number": "0143357868284",
            "isVoidable": true,
            "isRefundable": true,
            "refundTotals": {
                "subtotal": "778.00",
                "taxes": "71.90",
                "total": "849.90",
                "currencyCode": "GBP"
            }
        },
        {
            "number": "0143357868285",
            "isVoidable": true,
            "isRefundable": true,
            "refundTotals": {
                "subtotal": "778.00",
                "taxes": "71.90",
                "total": "849.90",
                "currencyCode": "GBP"
            }
        }
    ]
}

The reservation was not updated. Both tickets return options for void and refund.

Use Case 3 - Check multiple documents and define refund qualifiers

Below is an example of a simple round-trip air itinerary (PNR RECLOC: WLXFYU). These segments are booked as traditional Sabre air content:

*IA*T
1 EY7309Y 11JUN F AMSAUH*HK2  1115A  805P /DCEY*UTCAPI /E
 2 EY 377Y 11JUN F AUHBAH*HK2   935P  945P /DCEY*UTCAPI /E
 3 EY3154Y 21JUN M BAHAUH*TK2   130A  345A /DCEY*UTCAPI /E
 4 EY  77Y 21JUN M AUHAMS*HK2   930A  240P /DCEY*UTCAPI /E
TKT/TIME LIMIT
  1.T-11FEB-G7RE*AWX
  2.TE 6077531707952-AT DOE/J G7RE*AWX 0147/11FEB*
  3.TE 6077531707953-AT SMITH/L G7RE*AWX 0147/11FEB*          

Tickets were issued for both travelers:

ELECTRONIC TICKET RECORD                          CRS CODE:0011
INV:                  CUST:                          PNR:WLXFYU
TKT:6077531707952     ISSUED:11FEB21   PCC:G7RE   IATA:99999999
NAME:DOE/JOHN                                                  
FORM OF PAYMENT                        FCI: 0                  
1    CASH                                                      
CPN  A/L  FLT  CLS DATE   BRDOFF  TIME  ST F/B             STAT
1    EY   7309  Y  11JUN  AMSAUH 1115A  OK YLF2NL          OPEN
                                NVB:11JUN   NVA:11JUN   BAG:35K
2    EY   377   Y  11JUN  AUHBAH  935P  OK YLF2NL          OPEN
                                NVB:11JUN   NVA:11JUN   BAG:35K
3    EY   3154  Y  21JUN  BAHAUH  130A  OK YLF2NL          OPEN
                                NVB:21JUN   NVA:21JUN   BAG:35K
4    EY   77    Y  21JUN  AUHAMS  930A  OK YLF2NL          OPEN
                                NVB:21JUN   NVA:21JUN   BAG:35K

FARE     EUR1872.00                                            
TOTAL     USD2509.20     EQUIVALENT FARE PAID        USD2264.00
ELECTRONIC TICKET RECORD                          CRS CODE:0011
INV:                  CUST:                          PNR:WLXFYU
TKT:6077531707953     ISSUED:11FEB21   PCC:G7RE   IATA:99999999
NAME:SMITH/LAWRENCE                                            
FORM OF PAYMENT                        FCI: 0                  
1    CASH                                                      
CPN  A/L  FLT  CLS DATE   BRDOFF  TIME  ST F/B             STAT
1    EY   7309  Y  11JUN  AMSAUH 1115A  OK YLF2NLCH        OPEN
                                NVB:11JUN   NVA:11JUN   BAG:35K
2    EY   377   Y  11JUN  AUHBAH  935P  OK YLF2NLCH        OPEN
                                NVB:11JUN   NVA:11JUN   BAG:35K
3    EY   3154  Y  21JUN  BAHAUH  130A  OK YLF2NLCH        OPEN
                                NVB:21JUN   NVA:21JUN   BAG:35K
4    EY   77    Y  21JUN  AUHAMS  930A  OK YLF2NLCH        OPEN
                                NVB:21JUN   NVA:21JUN   BAG:35K

FARE     EUR1409.00                                            
TOTAL     USD1949.20     EQUIVALENT FARE PAID        USD1704.00

In order to execute the check flight ticket operation, determine the desired document numbers and applicable refund qualifiers.

For example, the request to check all documents could be:

{
    "tickets": [
        {
            "number": "6077531707952",
            "refundQualifiers": {
                "waiverCode": "ABCD1234",
                "commissionAmount": "25.00"
            }
        },
        {
            "number": "6077531707953",
            "refundQualifiers": {
                "overrideCancelFee": "0.00",
                "commissionAmount": "15.00",
                "overrideTaxes": [
                    {
                        "taxCode": "CJ",
                        "taxAmount": "5.00"
                    }
                ]
            }
        }
    ]
}

In this example, we specified different qualifiers for each ticket:

  • 6077531707952
    • waiverCode to apply a waiver code as provisioned by the issueing carrier
    • commissionAmount to apply a commission you will receive for this refund
  • 6077531707953
    • overrideCancelFee to specify the cancel fee
    • commissionAmount to apply a commission you will receive for this refund
    • overrideTaxes to apply refundable amounts for specific taxes

Caution! By defining refund qualifiers, you'll override Sabre system pricing. Use at your own risk.

There are no errors in the response:

{
    "request": {
        "tickets": [
            {
                "number": "6077531707952",
                "refundQualifiers": {
                    "commissionAmount": "25.00",
                    "waiverCode": "ABCD1234"
                }
            },
            {
                "number": "6077531707953",
                "refundQualifiers": {
                    "overrideCancelFee": "0.00",
                    "overrideTaxes": [
                        {
                            "taxCode": "CJ",
                            "taxAmount": "5.00"
                        }
                    ],
                    "commissionAmount": "15.00"
                }
            }
        ]
    },
    "tickets": [
        {
            "number": "6077531707952",
            "isVoidable": true,
            "isRefundable": true,
            "refundTotals": {
                "subtotal": "2264.00",
                "taxes": "245.20",
                "total": "2509.20",
                "currencyCode": "USD"
            }
        },
        {
            "number": "6077531707953",
            "isVoidable": true,
            "isRefundable": true,
            "refundTotals": {
                "subtotal": "1704.00",
                "taxes": "245.20",
                "total": "1949.20",
                "currencyCode": "USD"
            }
        }
    ]
}

The reservation was not updated. The tickets remain with open coupons.

Use Case 4 - Check NDC Order

Below is an example of a simple round-trip air itinerary (PNR RECLOC: IORVQO / Sabre Order ID: 1SXXXCITUW8P4). These segments are booked as NDC Sabre air content:

{
    "startDate": "2021-05-30",
    "endDate": "2021-06-05",
    "flights": [
        {
            "itemId": "10",
            "confirmationId": "4T3XNE",
            "sourceType": "NDC",
            "flightNumber": 444,
            "airlineCode": "QF",
            "operatingFlightNumber": 444,
            "operatingAirlineCode": "QF",
            "fromAirportCode": "MEL",
            "toAirportCode": "SYD",
            "departureDate": "2021-05-30",
            "departureTime": "13:00:00",
            "departureTerminalName": "1",
            "arrivalDate": "2021-05-30",
            "arrivalTime": "14:25:00",
            "arrivalTerminalName": "3",
            "cabinTypeName": "ECONOMY",
            "cabinTypeCode": "Y",
            "aircraftTypeCode": "73H",
            "aircraftTypeName": "BOEING 737 800",
            "bookingClass": "O",
            "meals": [
                {
                    "code": "H",
                    "description": "Hot meal"
                }
            ],
            "flightStatusCode": "HK",
            "flightStatusName": "Confirmed",
            "durationInMinutes": 85,
            "distanceInMiles": 456
        },
        {
            "itemId": "11",
            "confirmationId": "4T3XNE",
            "sourceType": "NDC",
            "flightNumber": 437,
            "airlineCode": "QF",
            "operatingFlightNumber": 437,
            "operatingAirlineCode": "QF",
            "fromAirportCode": "SYD",
            "toAirportCode": "MEL",
            "departureDate": "2021-06-05",
            "departureTime": "11:00:00",
            "departureTerminalName": "3",
            "arrivalDate": "2021-06-05",
            "arrivalTime": "12:35:00",
            "arrivalTerminalName": "1",
            "cabinTypeName": "ECONOMY",
            "cabinTypeCode": "Y",
            "aircraftTypeCode": "73H",
            "aircraftTypeName": "BOEING 737 800",
            "bookingClass": "O",
            "meals": [
                {
                    "code": "H",
                    "description": "Hot meal"
                }
            ],
            "flightStatusCode": "HK",
            "flightStatusName": "Confirmed",
            "durationInMinutes": 95,
            "distanceInMiles": 456
        }
    ],
    "flightTickets": [
        {
            "number": "0815740238620",
            "date": "2021-03-22",
            "travelerIndex": 1,
            "flightCoupons": [
                {
                    "itemId": "10",
                    "couponStatus": "Not Flown",
                    "couponStatusCode": "I"
                },
                {
                    "itemId": "11",
                    "couponStatus": "Not Flown",
                    "couponStatusCode": "I"
                }
            ],
            "payment": {
                "subtotal": "153.00",
                "taxes": "57.20",
                "total": "210.20",
                "currencyCode": "USD"
            },
            "ticketStatusName": "Issued",
            "ticketStatusCode": "TO"
        }
    ],
    "request": {
        "confirmationId": "1SXXXCITUW8P4",
        "returnOnly": [
            "FLIGHTS",
            "TICKETS"
        ]
    }
}

In this example, we will check void or refund options for the entire order using the Sabre Order ID:

{
    "confirmationId": "1SXXXCITUW8P4"
}

There are no errors in the response:

{
    "request": {
        "confirmationId": "1SXXXCITUW8P4"
    },
    "cancelOffers": [
        {
            "offerType": "VOID",
            "offerItemId": "cb7778589bcbb4hpnkmkhp4ya1",
            "offerExpirationDate": "2021-03-22",
            "offerExpirationTime": "11:53"
        }
    ]
}

The reservation was not updated and the order remains in its current state.

In this example, we're still in the void period and the only option is offerType: "VOID". To finally execute the void offer, apply "offerItemId": "cb7778589bcbb4hpnkmkhp4ya1" to your cancelBookingRequest.