Overview

Retrieve the current state of an experience booking by its booking ID, including status, pricing, and voucher details once available.

When to Use

• Poll for confirmation - Check whether a booking has moved from PENDING_CONFIRMATION to CONFIRMED
• Booking details page - Display status, price, and voucher to the guest
• Support queries - Look up a booking's current state

What You Get

• status - Current booking status (PENDING_CONFIRMATION, CONFIRMED, FAILED, CANCELLED)
• voucher - Ticket/reference details, once available
• price / commission / clientCommission - Your price and earnings for this booking
• Cancellation details - refund, cancellationRequestedAt, cancelledAt, refundProcessedAt, when applicable

Quick Start

GET with the bookingId from POST /experiences/bookings. Poll until status is CONFIRMED (or use webhooks), or retrieve the voucher once available.

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": "ueTM5wXBX",
    "prebookId": "tJHcT_KHA",
    "status": "PENDING_CONFIRMATION",
    "providerStatus": "completed",
    "tourId": 903304,
    "optionId": 1416025,
    "dateTime": "2026-07-18T07:00:00Z",
    "price": 101.25,
    "commission": 7.5,
    "clientCommission": 7.5,
    "currency": "EUR",
    "voucherCode": "SUMMER25",
    "voucherTotalAmount": 10,
    "paymentStatus": "succeeded",
    "paymentTransactionId": "tr_cts_test",
    "refund": {
      "refundAmount": 45.5,
      "refundType": "full",
      "estimateConfidence": "high",
      "currency": "EUR",
      "sellingPrice": 45.5
    },
    "customTags": {
      "WHITELABEL_DOMAIN": "partner.example"
    },
    "experienceSnapshot": {
      "version": 2
    }
  }
}