Decline a manual amendment
Declines the quoted price of a manual amendment.
Declines the quoted price of a manual amendment.
Only a Quoted request can be declined. No body and no money moves. Returns { amendmentId } and
moves the request to Cancelled; the booking is unchanged. Errors: 400 / 21103 in any other status,
404 / 10004 when not found.
PartnerApiKeyX-Partner-Key<token>Partner API Key (X-Partner-Key)
id*stringThe hotel order item's id, from items[].id of the order.
uuidamendmentId*stringThe amendmentId returned when the request was created.
uuidOK
- response
amendmentId*stringID of the amendment request.
uuidcurl -X POST 'https://api.sandbox.openroam.com/v1/order-items/01a1432e-7121-7b0e-a0a0-c35454d3b883/manual-amendments/497f6eca-6276-4993-bfeb-53cbbbba6f08/decline'{ "amendmentId": "f50ac643-fd02-46d5-9e8a-eb5968ac5fa0"}Request a manual amendment POST
Requests a manual change to a confirmed hotel booking. Requires an `Idempotency-Key` header (a UUID) and an API key with order-manage permission. Send the requested change as `attributes`: new `checkInDate` and `checkOutDate`, `holder` or `roomGuests` (one entry per booked room, `roomIndex` 1-based); anything omitted keeps its booked value. Returns `{ amendmentId }`; the request starts as `Pending` and nothing is charged until you approve a quote. The order item must be fulfilled, not refunded, use the manual amendment flow and have no open request (`Pending`, `InProgress`, `Quoted` or `PartnerApproved`). Errors: 400 / 21100 invalid request, 21101 booking not amendable, 21102 a request is already open, 21104 manual amendments not available, 21113 or 21114 invalid or unsupported room and guest changes; 404 / 10004 when the order item is not found. The same key after the request finished gives 409 / 12000: read the request it created with `GET /order-items/{id}/amendments`. While it is still running the key gives 409 / 12002 with `Retry-After`, and with a different body 409 / 12001.
Order flights POST
Places and pays for flight bookings, one fare per item. Takes the same body as quote, with `inputs` required. Requires an `Idempotency-Key` header (a new UUID per purchase) and an API key with order-manage permission. Repeating the same request with the same key returns the original order; while the first request is still running the response is 409 / 12002 with `Retry-After`, after which you send the same request again. The order is paid from your wallet balance and ticketing completes asynchronously: track it with `GET /orders/{id}` or the `order.fulfillment.updated` webhook. `publicId` is a fare's `publicId` from search, or one that a quote returned. `inputs.passengers` lists every passenger of the fare exactly once, in `passengerIndex` order 1 to N, optionally with seats in `selectedSeats`; paid baggage and other services go in `inputs.selectedServices`. Seats and services are checked against the airline's current offer and seat map, and their prices are added to the item's price. Each item is priced again with the airline before payment, and the price is capped. With the optional `inputs.maxPrice`, in the order currency, a higher price for the item (the fare with its paid extras) gives 409 / 11002 at `items[i].inputs.maxPrice`. Without it, the fare may not cost more than the price returned with the `publicId` (409 / 11002 at `items[i]`), and the order must be in the currency of that price (400 / 11005 at `items[i]`). A `publicId` keeps that price: after 409 / 11002, quote again and order with the `publicId` the quote returns, or send `inputs.maxPrice`. Each item is checked completely before the next one, and the first failure names its item: an invalid input or missing `inputs` gives 400 / 10001 at its path under `items[i]`, for example `items[0].inputs.passengers[0].email`; an unknown, expired or another partner's `publicId` 400 / 11004 at `items[i]`; an offer the airline no longer sells 409 / 11003 at `items[i]`. A wallet charge that fails gives 402 / 16000, with `details[0]` naming `wallet` and `INSUFFICIENT_BALANCE` or `WALLET_BLOCKED`; send the same request with the same key after a top-up. Nothing is created or charged when the order is refused.