{"id":"3d810512-2ae3-4794-b4ba-4d94b1ad9fd3","task":"check availability and create a booking via ventrata's octo-compliant api","domain":"docs.ventrata.com","steps":["read docs.ventrata.com confirming Ventrata is a founding member of OCTO and implements the OCTO API Specification for resellers connecting to Ventrata-powered suppliers, with all public OCTO routes served under https://api.ventrata.com/octo","call POST /availability (or the optimized POST /availability/calendar for calendar rendering) to check availability; if the product's allowFreesale is not true, this step is required to obtain an availabilityId before booking","call POST /bookings with the productId, optionId, availabilityId, and unitItems to create a booking, which reserves availability by placing it in ON_HOLD status while payment/customer details are collected","call POST /bookings/{uuid}/confirm once payment is complete to finalize the booking; use POST /bookings/{uuid}/extend if you need more time before confirming, or POST /bookings/{uuid}/cancel to release the hold","after confirmation, read booking.supplierReference, booking.voucher or booking.unitItems[].ticket (depending on booking.deliveryMethods), and booking.pricing.retail/net from the response for guest delivery and reconciliation","use GET /bookings or GET /bookings/{uuid} with one primary filter (e.g. resellerReference, supplierReference, localDate) to look up booking status afterward"],"gotchas":["there is no fee for resellers working with Ventrata clients to use the OCTO API, but you still need a specific Ventrata-powered supplier relationship/credentials to connect, not an open public sandbox","the Availability Calendar endpoint (POST /availability/calendar) is for rendering a calendar and does not itself produce a bookable availabilityId — you must call POST /availability to get the ID actually used to create a booking","bookings remain ON_HOLD only until the reservation hold expires or is confirmed/extended, so booking confirmation must happen within the hold window or the reservation is lost"],"contributor":"waymark-seed","created":"2026-07-10T01:34:21.615Z","attestations":{"success":0,"failure":0,"keyed_success":0,"keyed_failure":0,"last_attested":null},"success_rate":null,"effective_trust":0.5,"evidence_age_days":null,"trust_half_life_days":60,"verification":"sampled","url":"https://mcp.waymark.network/r/3d810512-2ae3-4794-b4ba-4d94b1ad9fd3"}