Reshop order

POST /json/{version}/orders/{orderId}/reshop shops replacement flights or quotes the impact of cancelling or changing a booking. It is the JSON counterpart of the NDC IATA_OrderReshopRQ.

For itinerary changes, reshop is the first step of the change flow: reshop → quote order → change order with AcceptReshopOffer. Offers returned here must be priced with quote order, not price offer.

Authorization

Reshop requires full transaction (book) permissions on the API key.

Request

Field	Description
instruction	One instruction object — see below.
passengers	Passengers in scope: paxId (required, from the retrieved order) and type.

Instruction type	Description
ReshopItinerary	Shops replacement flights for new originDestinations; optional deleteOrderItemRefIds and cabinTypeCode.
CancelOrder	Quotes the penalty and refund for cancelling the whole order.
DeleteOrderItems	Quotes removal of specific order items by orderItemRefIds.
NameChange	Quotes a passenger name change (paxRefId, surname, optional givenName).

POST /json/v0/orders/ABC123/reshop
Authorization: <bearer token from /auth/token>
Content-Type: application/json

{
  "instruction": {
    "type": "CancelOrder"
  },
  "passengers": [
    {
      "paxId": "PAX-eyJ2IjoxfQ",
      "type": "ADT"
    }
  ]
}

Response

data.offers lists replacement offers (empty for pure cancellation quotes). A CancelOrder instruction returns cancellation with penaltyAmount, refundAmount, and isRefundable; commit cancellation through change order. A NameChange instruction returns nameChange.fee.

{
  "data": {
    "orderId": "ABC123",
    "recordLocator": "ABC123",
    "pax": [
      {
        "paxId": "PAX-eyJ2IjoxfQ",
        "ptc": "ADT"
      }
    ],
    "offers": [],
    "cancellation": {
      "penaltyAmount": {
        "amount": 50,
        "currency": "USD"
      },
      "refundAmount": {
        "amount": 150,
        "currency": "USD"
      },
      "isRefundable": true
    }
  },
  "error": null
}

Reshop order errors

Code	HTTP status	Cause
ERR-1002	404	Unsupported version segment in the path.
ERR-1005	422	Request validation failed.
ERR-4000	404	Order not found.
ERR-4002	400	Requested change could not be quoted.
ERR-8000	401	Missing or invalid API key or bearer token.
ERR-8001	403	API key lacks full transaction permissions.
ERR-8002	503	Authentication store unavailable.
ERR-9003	500	Reshop failed upstream.