Reservation Cancel API Reference (GDS)

POST

receipt/reservations/{LocatorCode}/receipts

For {AggregatorLocatorCode} send the locator code returned at booking or in Reservation Retrieve in Receipt/Confirmation/Locator/value.

Hotel bookings return multiple locator codes. Send the value from the instance of Receipt with Confirmation/Locator/locatorType=PNR Locator. See Locator Codes for details.

Base path:

Pre-production https://api.pp.travelport.net/11/air/

Production https://api.travelport.net/11/air/

Travelport has updated all JSON API authentication and authorization endpoints. Previous pre-production endpoints were deprecated 5 Dec 2025. Previous production endpoints are scheduled for deprecation 30 Jan 2026. API transactions using these endpoints after these dates in those environments will fail. See Endpoint Migration for details.

Related Content: Booking Guide, Reservation Retrieve Guide

Canceling a GDS reservation requires a single cancel request as detailed here. A reservation is a held booking that has not been ticketed.

Alternately, you can use Cancel Workbench Items to cancel the booking, which requires a flow with workbench create and a workbench commit instead of a single call.

To cancel an NDC reservation, see the Cancel API Reference (NDC).

Request

As part of the request requirements, also see Authentication and Common Air Headers.

Query Parameters

None.

Request Body

To cancel a reservation, send a POST request that includes the reservation to cancel to the endpoint above. There is no message payload.

Response

Show Response Body Table

Object	Description
ReceiptListResponse	Top level object for response. Includes ReceiptID object.
ReceiptID	Top level object for cancellation details. Key value pair: id: Internal identifier.
Identifier	Identifier details for this transaction. In this case, authority is always Travelport and value provides a system-generated internal idnetifier for the response. Key value pairs. authority: Source of information. value: Unique system-generated identifier.
Cancellation	Top level object for cancellation details. type: Cancellation status. Includes the Locator object.
Locator	Cancellation details of the canceled itinerary in the following key value pairs: type: Cancellation status. source: Provider on which the reservation was created; for GDS this value is 1G. sourceContext: For GDS always returns the value Travelport. value: The reservation locator code of the canceled reservation.

Example Request

There is no message payload.

Example Response

Show Example GDS reservation Cancel Response

{
    "ReceiptListResponse": {
        "ReceiptID": [
            {
                "@type": "ReceiptCancellation",
                "id": "receipt_1",
                "Identifier": {
                    "authority": "Travelport",
                    "value": "bae9f140-ff5e-4685-b72f-70a6ef9beedd"
                },
                "Cancellation": {
                    "@type": "CancellationHold",
                    "Locator": {
                        "locatorType": "Locator",
                        "source": "1G",
                        "sourceContext": "Travelport",
                        "value": "0GM4S1"
                    }
                }
            }
        ]
    }
}