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-4007`	`400`	Journey already flown, or a passenger boarded or no-showed; nothing to cancel or reshop.
`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.