v1

latestOpenAPI 3.0.4License2026-07-14643173.0 KB
Booking

Creates or amends a Booking.

This operation should be idempotent. Requests to this endpoint that fail may be retried after a few minutes. See more in the Responses section. If the issue persists, the fallback integration mechanism will be used (A.K.A. the email or FTP delivered XML file).

put/v1/bookings/{bookingReference}

Path parameters

bookingReferencestring required

Request body

modificationType'Amendment' | 'TransferDeclined' | 'TransferNotProvided' | 'ExtraNotProvided' | 'LateCollection' | 'DriverNoShow' required

The type of modification being made to a Booking.

Response

200 OK: The Booking has been amended. Signals that the amendment has happened synchronously. That means that the Booking and this update is already available and valid in the supplier's system. See 202 for the asynchronous version.

bookingReferencestring required

The Suntransfers Booking reference identifier. This is currently a string starting with 'SUNTR_' followed by alphanumeric characters.

supplierReferencesSupplierReference[] nullable

The Supplier's internal Transfer references or IDs.