---
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`

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.

---

[API](https://skmtc.net/spotnana/apis/trip-api.md) · [All operations](https://skmtc.net/spotnana/apis/trip-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/spotnana/trip-api/revisions/95d2773f6a09/schema)