Skip to Content
OpenRoam Docs
Hotel manual amendments

Decline a manual amendment

Declines the quoted price of a manual amendment.

POST
/v1/order-items/{id}/manual-amendments/{amendmentId}/decline

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.

Authorization

PartnerApiKey
headerX-Partner-Key<token>

Partner API Key (X-Partner-Key)

Path Parameters

id*string

The hotel order item's id, from items[].id of the order.

Formatuuid
amendmentId*string

The amendmentId returned when the request was created.

Formatuuid

Response Body

OK

  1. response
amendmentId*string

ID of the amendment request.

Formatuuid
Example Request
curl -X POST 'https://api.sandbox.openroam.com/v1/order-items/01a1432e-7121-7b0e-a0a0-c35454d3b883/manual-amendments/497f6eca-6276-4993-bfeb-53cbbbba6f08/decline'
Example Response
{  "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.