Overview

Cancel a confirmed experience booking and trigger any applicable refund.

When to Use

• Guest-initiated cancellation - After the guest confirms via the cancel-preview screen

What You Get

• status - Booking status after cancellation
• providerStatus - Raw upstream provider status, when available
• refund - Present when a refund was calculated; refundPending indicates it hasn't settled yet

Quick Start

POST with the bookingId from POST /experiences/bookings. Call GET /experiences/bookings/{bookingId}/cancel-preview first to show the guest the refund amount.

Error codes

Product-operation codes are listed below. Shared authentication/access/rate-limit middleware can return common codes such as 401, 40301 or 4290. HTTP status and error code are separate; do not parse message text.

{
  "data": {
    "bookingId": "444fe833-a84e-49b4-ae9f-b032c8619419",
    "status": "cancelled",
    "providerStatus": "CANCELLED",
    "refundPending": true,
    "refund": {
      "refundAmount": 45.5,
      "refundType": "full",
      "estimateConfidence": "high",
      "currency": "EUR",
      "sellingPrice": 45.5
    }
  }
}