Sign in

v1

latestOpenAPI 3.1.02026-08-0630894634.3 KB
Trip PNRs

Create PNR

Create a new Passenger Name Record (PNR). A PNR represents a booking (air, hotel, rail, or car) made on the Spotnana platform. You can also use this endpoint to import bookings made from external sources into the Spotnana platform.

post/v3/trips/{tripId}/pnrs

Request body

versioninteger

Current PNR version. This field is used for handling conflicts in case of concurrent updates. This should be sent unmodified in update request.

createdVia'OFFLINE' | 'OBT' | 'SHELL' | 'PASSIVE' | 'API'

Indicates the source of creation of PNR, like SHELL, OBT, etc.

initialVersionCreatedVia'OFFLINE' | 'OBT' | 'SHELL' | 'PASSIVE' | 'API'

Indicates the source of creation of PNR, like SHELL, OBT, etc.

invoiceDelayedBookingboolean

True if the billing is delayed

isFinalizedboolean

Indicates if finalize action has been performed on the pnr.

bookingStatus'UNKNOWN_STATUS' | 'PENDING_STATUS' | 'CONFIRMED_STATUS' | 'ACTIVE_STATUS' | 'COMPLETED_STATUS' | 'CANCELLED_STATUS' | 'REFUNDED_STATUS' | 'VOIDED_STATUS' | 'PROCESSING_STATUS' | 'UNCONFIRMED_STATUS' | 'AIRLINE_CONTROL_STATUS' | 'PAYMENT_DECLINED_STATUS' | 'SCHEDULE_CHANGE_STATUS' | 'HOLD_STATUS' | 'APPROVAL_REQUESTED_STATUS' | 'APPROVAL_DENIED_STATUS' | 'CANCELLATION_IN_PROGRESS_STATUS' | 'INOPERATIVE_STATUS' | 'FLIGHT_UNCONFIRMED_STATUS'

User facing booking status

contactSupportboolean

Set to true if there might be an issue in the PNR for which the user should be warned to contact TMC support.

travelerPnrVisibilityStatus'VISIBLE' | 'HIDDEN'

Represents the PNR visibility status, if marked as HIDDEN should not be displayed to the traveler

cancellationRequestStatus'CANCELLATION_IN_PROGRESS' | 'CANCELLATION_BY_AGENT_REQUESTED'

Status of in progress cancellation request CANCELLATION_IN_PROGRESS - Cancellation request is in progress via OBT CANCELLATION_BY_AGENT_REQUESTED - Cancellation request is in progress via agent

tripIdstring

Spotnana trip ID to which the PNR belongs to

pnrIdstring

Spotnana PNR ID

dkNumberstring

DK number attached to the PNR.

suspendReason'AIR_PRICE_OPTIMIZATION' | 'EXCHANGE' | 'GDS_EXCHANGE'

Reason for suspending the pnr

state'ITINERARY' | 'PNR'

State of the PNR

Response

Created

idstring