From 4d157365b7af932ec419dbbff40413c879b48b6f Mon Sep 17 00:00:00 2001 From: lrcarrera Date: Mon, 28 Sep 2026 09:52:59 +0200 Subject: [PATCH] Document required bookable.price and the 400 on POST /{version}/bookings Companion to getyourguide/public-partner-api: a booking request without bookable.price used to fail with a 500 and now returns 400 (errorCode 12). Description-only change; price was already listed as required. Co-Authored-By: Claude Fable 5.1 --- spec/paths/bookings.yaml | 5 ++++- 1 file changed, 4 insertions(+), 1 deletion(-) diff --git a/spec/paths/bookings.yaml b/spec/paths/bookings.yaml index 3b7fae1..8e908cd 100644 --- a/spec/paths/bookings.yaml +++ b/spec/paths/bookings.yaml @@ -6,7 +6,10 @@ paths: /{version}/bookings: post: operationId: BookingsCreate - description: A booking request can create a shopping cart or add to an existing shopping cart. Either coupon or bookable must be sent in the body of the request. + description: | + A booking request can create a shopping cart or add to an existing shopping cart. Either coupon or bookable must be sent in the body of the request. + + When `bookable` is sent, `option_id`, `datetime`, `price` and `categories` are required. A request that omits `bookable.price` is rejected with a `400` (`errorCode` 12, `Booking price is required.`) before any availability or pricing lookup is made; the `price` value itself is then checked against the current price of the option and a mismatch is rejected with `errorCode` 308. summary: Create a new booking. tags: - Bookings