Modify Book

API reference

Air

Modify Book

Request

Book[cancel] new[existing] legs into an existing pnr using the selected rate option from airModifySearch operation.

Security

Bearer

Bodyapplication/jsonrequired

bookingIdstringrequired

Booking id returned in successful response of air-revalidate-itin api call in the booking flow.

Example:"ChBlMTFmOTVkZTcwZmZjMmI2EhAwZjVkNDhhNGJjNWExZTMw"

tripDataobject(TripData)required

Trip data to book a PNR.

Example:

{
  "tripId": {
    "id": "9527251668"
  }
}

skipTicketingboolean

If this is true, the PNR is not set up for ticketing.

Example:true

postPaymentVerificationInfoPostStripeVerificationInfoWrapper (object) or PostUrlBasedVerificationInfoWrapper (object) or AmadeusCheckoutVerificationInfoWrapper (object) or ThreeDSecure2PostVerificationInfoWrapper (object) or RazorpayPostVerificationInfoWrapper (object)(PostPaymentVerificationInfo)

One of:

Wrapper for post stripe verification info object.

customFieldV3ResponsesArray of objects(CustomFieldV3Response)

Custom field responses for the booking.

waiveOffInfoobject(WaiveOffInfo)

Waive off info.

callbackUrlVerificationInfoobject(CallbackUrlVerificationInfo)

Callback URL information for post-verification redirect.

curl -i -X POST \
  https://api-ext-sboxmeta.partners.spotnana.com/v2/air/modify-book \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "bookingId": "ChBlMTFmOTVkZTcwZmZjMmI2EhAwZjVkNDhhNGJjNWExZTMw",
    "tripData": {
      "tripId": {
        "id": "9527251668"
      }
    }
  }'

Responses

Bodyapplication/json

pnrNumberstring(Source PNR ID)

Example:"ABXDFZ"

pnrStatusstring(PnrStatus)

Status of PNR

Enum Value	Description
UNKNOWN	PNR status could not be determined or mapped from the supplier.
INITIATED	Default status when a PNR entity is first created in our database. The booking may not yet be confirmed by the supplier, and we may not have a vendor confirmation ID.
CANCELLED	The booking or flight is cancelled. Terminal status.
CONFIRMED	Booking confirmed by the supplier. For Air PNRs, confirmed but not yet ticketed (no active tickets).
GROUP_BOOKING_ON_REQUEST	Group booking requested but not yet confirmed. Air only
WAITLISTED	Booking is on a waitlist, pending confirmation by the supplier.
PENDING	Booking is awaiting confirmation or action. Used across all PNR types as a catch-all for not-yet-confirmed states.
AIRLINE_UPGRADE	Passenger upgraded by the airline. Not directly mapped by any supplier.
WAITLIST_CONFIRMED	Previously waitlisted booking confirmed by the supplier. Air only
BOOKING_DENIED_CONTACT_SUPPORT	Booking denied by the supplier, requires support intervention. Air only
NO_SHOW	Passenger did not show up for the flight or hotel stay.
CONTACT_SUPPORT	Requires manual agent/support intervention. Mapped from the `OK` passive-confirmation action code in GDS systems, indicating the segment was manually confirmed and needs verification.
STATUS_CHANGED_CONTACT_SUPPORT	Booking status changed by the supplier, requires support review. Air only
SCHEDULE_CHANGE	Schedule change applied to the booking by the airline. Booking is still active but flight times or routing may have changed.
SEGMENT_REQUEST	Passive Segment requested but not yet confirmed by the supplier.
SCHEDULE_CHANGE_WAITLISTED_BOOKING	Waitlisted booking with a schedule change applied. Air only
REQUEST_PENDING	Booking request submitted but only partially confirmed or awaiting further processing. Rail, and Hotel only.
WAITLISTED_NOT_CONFIRMED	Waitlisted booking not confirmed by the supplier. Not directly mapped by any supplier.
SCHEDULE_CHANGE_NOT_CONFIRMED	Schedule change occurred but booking not reconfirmed. Not directly mapped by any supplier
SCHEDULE_CHANGE_PENDING_STATUS	Schedule change proposed but pending confirmation/action. Air only
MIS_CONNECTION	Misconnection — passenger missed a connecting flight. Not directly mapped by any supplier
REQUESTED	Booking initiated but no vendor confirmation ID exists yet. Intermediate state between INITIATED and CONFIRMED. When segments have blank confirmation IDs;
TICKETED	Tickets issued and payment charged for an Air PNR. Terminal status for successful air bookings.
VOIDED	All tickets voided — any charged amount refunded, including non-refundable bookings. Terminal status.
CANCELLED_BY_VENDOR	Booking cancelled by the vendor/airline, not by the traveler.
CANCELLATION_IN_PROGRESS	Cancellation initiated but not yet complete. Also set internally during the air cancellation workflow before the supplier call completes.
REINSTATED	Previously cancelled flight became active again. Air only. Not mapped from any GDS status code directly.
BOOKING_ON_HOLD	Air PNR confirmed with the airline but held for a limited time before auto-cancellation if not ticketed. Requires active hold metadata (`REQUESTED` or `ON_HOLD` hold status). Air only
AIRLINE_CONTROL	PNR taken over by the airline. Updates no longer visible to the TMC. Terminal status.
MODIFIED	Booking has been modified/rebooked. Car: CarTrawler `Rebooked` status. Also referenced in Sabre Hotel mapper for modified hotel PNR handling.
PAYMENT_DECLINED	Payment failed during ticketing. Retained as long as unticketed fare quotes exist (Sabre PQ/PQR or Amadeus TSTs), preventing incorrect progression to TICKETED.
INOPERATIVE	Booking inoperative or unavailable for use.
UNCONFIRMED	Booking unconfirmed and pending verification.

Example:"CONFIRMED"

pnrIdstring

Spotnana PNR ID

Example:"1213124111"

paymentVerificationInfoStripeVerificationInfoWrapper (object) or UrlVerificationInfoWrapper (object) or ThreeDSecure2VerificationInfoWrapper (object) or RazorpayVerificationInfoWrapper (object)(PaymentVerificationInfo)

One of:

Wrapper for stripe verification Info.

processingWarningstring

Optional warning message if processing is taking longer than expected

Example:"Modification is successful but update is taking longer than expected"

Response

{
  "pnrNumber": "AXKJDF",
  "pnrStatus": "CONFIRMED",
  "pnrId": "1213124111"
}