--- title: "Get cancellation details" method: GET path: "/v2/trips/{tripId}/pnrs/{pnrId}/cancellation-details" tags: ["Trip PNRs"] --- # Get cancellation details `GET /v2/trips/{tripId}/pnrs/{pnrId}/cancellation-details` ## Request - Base URL: `https://api-ext-sboxmeta.partners.spotnana.com` - URL: `https://api-ext-sboxmeta.partners.spotnana.com/v2/trips/{tripId}/pnrs/{pnrId}/cancellation-details` - Auth: HTTP bearer This endpoint gets cancellation details for a given trip ID and PNR ID. ## Response `200` OK - PnrCancellationDetails: Cancellation details for a booking. - `pnrId` string, required: PNR ID for the booking. - `tripId` string, required: Trip ID for the booking. - `cancellationDetails` union: Cancellation details for this booking - object: Wrapper for AirCancellationDetails - `air` AirCancellationDetails: Cancellation details for air booking. - `travelers` AirTravelerCancellationInfo[], required: Cancellation information for travelers in this booking. - `userId` UserId, required: User identifier - `id` string, uuid, required - `travelerInfo` union: The traveler identifiers. These can be either the Spotnana user IDs of the travelers or information regarding the adhoc travelers. - object: Wrapper over UserId object to be used as an identifier in a oneOf case - … - object: Wrapper over AdhocTravelerInfo object to be used as an identifier in a oneOf case. - … - `tickets` TicketCancellationInfo[], required: Cancellation information for traveler tickets. - `ticketNumber` string: Ticket number. For non-ticketed PNRs, this field will not be present. - `ticketType` 'FLIGHT' | 'ANCILLARY', required: Type of ticket. - `ticketFare` FareAmount, required: Fare amount including base fare and tax. - … - `cancellationState` 'CANCELLABLE_BY_OBT' | 'CANCELLABLE_BY_SUPPORT' | 'NON_CANCELLABLE' | 'CANCELLATION_IN_PROGRESS' | 'CANCELLATION_BY_AGENT_REQUESTED' | 'CANCELLED' | 'CANCELLATION_INFO_NOT_AVAILABLE', required: - CANCELLABLE_BY_OBT: Cancellation possible via API. - CANCELLABLE_BY_SUPPORT: Cancellation possible via agent support. - NON_CANCELLABLE: Booking is non-cancellable. - CANCELLATION_IN_PROGRESS: Cancellation is in progress. - CANCELLATION_BY_AGENT_REQUESTED: Cancellation request has been sent to agent. - CANCELLED: Already cancelled. - CANCELLATION_INFO_NOT_AVAILABLE: Cancellation information not available. - `cancellationOptions` AirCancellationOption[]: Cancellation options for this ticket. A ticket can have multiple options, like refunding ticket, converting ticket to flight credits. - … - `cancellationNotSupportedReasons` AirCancellationNotSupportedReason[]: Reasons why cancellation is not supported via OBT. - `isNonRefundableAndNonExchangeable` boolean: If true, the ticket is not refundable and not exchangeable. - `cancellationOptions` AirCancellationOption[]: Cancellation options for this traveler. - `cancellationType` 'REFUND' | 'VOID' | 'UNUSED_CREDITS': Type of cancellation. - `fareInfo` AirFareInfo, required: Fare breakup for cancellation. - … - `offerExpiryInfo` OfferExpiryInfo: Date time in UTC till when this cancellation offer is valid. For example void window expiry. - … - `optionId` string: Unique id for this cancellation option. - `cancellationOptions` AirCancellationOption[]: Cancellation options for this booking. - `cancellationType` 'REFUND' | 'VOID' | 'UNUSED_CREDITS': Type of cancellation. - `fareInfo` AirFareInfo, required: Fare breakup for cancellation. - `totalFare` FareAmount, required: Fare amount including base fare and tax. - … - `usedFare` FareAmount, required: Fare amount including base fare and tax. - … - `nonRefundableFare` FareAmount, required: Fare amount including base fare and tax. - … - `cancellationFee` FareAmount, required: Fare amount including base fare and tax. - … - `merchantFee` Money, required: Money object containing details such as the amount, the currency code, and the converted amount. - … - `refund` FareAmount, required: Fare amount including base fare and tax. - … - `flightCredits` FlightCredits: Flight credits for a traveler. - … - `offerExpiryInfo` OfferExpiryInfo: Date time in UTC till when this cancellation offer is valid. For example void window expiry. - `dateTime` DateTimeOffset, required: ISO8601 UTC Date Time - … - `optionId` string: Unique id for this cancellation option. - `cancellationState` 'CANCELLABLE_BY_OBT' | 'CANCELLABLE_BY_SUPPORT' | 'NON_CANCELLABLE' | 'CANCELLATION_IN_PROGRESS' | 'CANCELLATION_BY_AGENT_REQUESTED' | 'CANCELLED' | 'CANCELLATION_INFO_NOT_AVAILABLE', required: - CANCELLABLE_BY_OBT: Cancellation possible via API. - CANCELLABLE_BY_SUPPORT: Cancellation possible via agent support. - NON_CANCELLABLE: Booking is non-cancellable. - CANCELLATION_IN_PROGRESS: Cancellation is in progress. - CANCELLATION_BY_AGENT_REQUESTED: Cancellation request has been sent to agent. - CANCELLED: Already cancelled. - CANCELLATION_INFO_NOT_AVAILABLE: Cancellation information not available. - `cancellationNotSupportedReasons` AirCancellationNotSupportedReason[]: Reasons why cancellation is not supported via OBT. - object: Wrapper for RailCancellationDetails - `rail` RailCancellationDetails: Cancellation details for rail booking. - `refundOptions` RailRefundOption[]: Refund options for this booking. - `refundId` string, required: Refund option id. - `refundRateInfo` RailRefundRateInfo, required: Rate information for this refund option. - `totalFare` FareAmount, required: Fare amount including base fare and tax. - … - `nonRefundableFare` FareAmount: Fare amount including base fare and tax. - … - `cancellationFee` Money: Money object containing details such as the amount, the currency code, and the converted amount. - … - `refund` Money: Money object containing details such as the amount, the currency code, and the converted amount. - … - `voucher` RailRefundVoucher: Refund voucher information for this refund option. - … - `legs` integer[]: List of leg indices for the refund option. ## Other responses - `401`: Unauthorized - `403`: Forbidden - `404`: The specified resource was not found. ## Changes - **2026-10-29** `86dbf1e03dae`: 87 warning - added the new `DELAYED_PAYMENT` enum value to the `cancellationDetails/oneOf[subschema #1: AirCancellationDetailsWrapper]/air/cancellationOptions/items/fareInfo/cancellationFee/base/otherCoinage/items/coinageCode` response property for the response status `200` - added the new `DELAYED_PAYMENT` enum value to the `cancellationDetails/oneOf[subschema #1: AirCancellationDetailsWrapper]/air/cancellationOptions/items/fareInfo/cancellationFee/tax/otherCoinage/items/coinageCode` response property for the response status `200` - added the new `DELAYED_PAYMENT` enum value to the `cancellationDetails/oneOf[subschema #1: AirCancellationDetailsWrapper]/air/cancellationOptions/items/fareInfo/cancellationFee/taxBreakdown/items/amount/otherCoinage/items/coinageCode` response property for the response status `200` - added the new `DELAYED_PAYMENT` enum value to the `cancellationDetails/oneOf[subschema #1: AirCancellationDetailsWrapper]/air/cancellationOptions/items/fareInfo/flightCredits/changePenalty/base/otherCoinage/items/coinageCode` response property for the response status `200` - …83 more - …earlier changes not shown [Operation history](https://skmtc.dev/spotnana/apis/trip-api/changes/v2/trips/:tripId/pnrs/:pnrId/cancellation-details/get.md) --- [API](https://skmtc.dev/spotnana/apis/trip-api.md) - [All operations](https://skmtc.dev/spotnana/apis/trip-api/llms.txt) - [OpenAPI document](https://skmtc.dev/spotnana/apis/trip-api/revisions/506fca66cea6?raw)