Reschedule a booking to a different slot or, for custom bookings, a new time

POST/v2/bookings/{id}/reschedule

Requires your API key in the X-API-Key header.

Moves a PENDING, ACCEPTED or COMPLETED booking. The payload carries exactly one of:

  • availabilitySlotId — move to a different availability slot of the same option.
  • localTime — custom bookings only: a custom booking's synthesised option is pinned to exactly one slot, so there is never another slot to move to — instead the slot itself (and the option's window/schedule config) moves to the given wall-clock time in the experience's timezone. Manually attached resource blocks move with it, re-checked for conflicts at the new window. No cut-off check (same trust as creation); refused more than 24 hours in the past.

Pricing is preserved in both modes. In one transaction: old resource blocks are freed (slot mode) or moved (localTime mode), the new slot's capacity and resource availability are validated and reserved, and the booking's date/time move to the new slot. While PENDING, the organizer response deadline is recalculated. A COMPLETED booking moved to a new slot returns to ACCEPTED and re-completes automatically once the new date has passed; its captured payment is untouched.

Guards (400)

  • booking status is not PENDING/ACCEPTED/COMPLETED
  • the payment was refunded — the guest's money was returned and there is no re-collection flow, so the booking cannot re-enter the lifecycle
  • neither or both of availabilitySlotId and localTime provided
  • availabilitySlotId unknown, inactive or not bookable
  • the slot belongs to a different option, or is the booking's current slot
  • localTime on a non-custom booking, malformed, equal to the current start, or more than 24 hours in the past
  • a future slot inside the experience's cut-off window. Past slots are allowed (a date change may record what actually happened), guarded only by the accounting rule below
  • the new slot no longer has capacity or free resources
  • the booking is externally sourced (Bokun/Regiondo) — rescheduling external bookings is not supported
  • the current or the target month already has an issued organizer invoice (closed accounting period)

Side effects

"Booking updated" emails to traveler and organizer, resource notifications, reseller update notification, and the PMS folio is updated to "Updated".

Requestbash
curl -X POST "https://api.turneo.co/v2/bookings/0b7f5f7e-1234-4c56-89ab-4d5e6f7a8b9c/reschedule" \
  -H "X-API-Key: <your-api-key>" \
  -H "Content-Type: application/json" \
  -d '{
    "availabilitySlotId": "3c4d5e6f-7a8b-4c9d-0e1f-2a3b4c5d6e7f"
  }'

Path parameters

  • idstringrequired

    Booking UUID or booking code.

    Example:
    0b7f5f7e-1234-4c56-89ab-4d5e6f7a8b9c

Request bodyapplication/json, required

  • availabilitySlotIdstring (uuid)

    UUID of the new availability slot. Must belong to the same option, be bookable and differ from the current slot.

    Example:
    3c4d5e6f-7a8b-4c9d-0e1f-2a3b4c5d6e7f
  • resourcesstring (uuid)[]

    Resource UUIDs the moved booking should hold, one per resource group of the option. Omitted, the best-fit resources are resolved again and the booking may change resource; given, exactly the listed resources are held and the move is refused when one of them is busy or when the booking would not need all of them. Every id must belong to the option's resource groups. Custom bookings keep their resources, so the list must match the current ones.

  • localTimestring

    Custom bookings only — the new start as naive wall-clock time in the experience's timezone (same format as add-custom-booking's localTime). Moves the custom option's single slot in place. Refused on non-custom bookings, when equal to the current start, or more than 24 hours in the past.

    Example:
    2026-08-12T06:00:00
Example: move
movejson
{
  "availabilitySlotId": "3c4d5e6f-7a8b-4c9d-0e1f-2a3b4c5d6e7f"
}
Example: moveCustomBooking
moveCustomBookingjson
{
  "localTime": "2026-08-12T06:00:00"
}

Responses

200object

The rescheduled booking.

  • idstring (uuid)

    Booking UUID.

    Example:
    0b7f5f7e-1234-4c56-89ab-4d5e6f7a8b9c
  • bookingCodestring

    Short human-friendly booking code, unique per booking. Usable in place of the UUID in every /v2/bookings/{id} URL.

    Example:
    AC3F1TT2
  • bookingStatusstring

    Lifecycle status: ON_HOLD (in cart), PENDING (awaiting organizer), ACCEPTED, COMPLETED, CANCELLED, EXPIRED, NO_SHOW, REJECTED. (REMOVED exists internally but is never returned.)

    Allowed values:
    ON_HOLDPENDINGACCEPTEDCOMPLETEDCANCELLEDEXPIREDNO_SHOWREJECTED
    Example:
    ACCEPTED
  • experienceobjectnullable

    The booked experience, embedded in full (same shape as the v2 experience read serializer — see the Experiences group for the complete field reference). Key fields listed here.

    Child fields
    • idstring (uuid)

      Experience UUID.

      Example:
      9b2e6c7d-1f2a-4b3c-8d9e-0a1b2c3d4e5f
    • nameobject

      Multilingual experience name keyed by language code.

    • locationobject

      Experience location (city, country, coordinates).

    • imagesobject[]

      Experience images.

    • organizerobject

      Embedded organizer summary (name, partnerId, contact details, rating).

    • refundPolicyobjectnullable

      Tiered refund policy driving cancellation fees. Null means non-refundable.

    • cutOffTimeinteger

      Minimum notice (hours) required to book or reschedule.

      Example:
      2
  • optionobjectnullable

    The booked option, embedded in full (same shape as the v2 option read serializer — see the Options group for the complete field reference), including its variants, add-ons and extra fields. Key fields listed here.

    Child fields
    • idstring (uuid)

      Option UUID. variantId and availabilitySlotId on the booking reference into this option.

      Example:
      0d9f4c1a-2b3c-4d5e-8f9a-0b1c2d3e4f5a
    • nameobject

      Multilingual option name.

    • pricingModelstring

      Pricing model of the option (e.g. PER_PARTICIPANT, FLAT_RATE, DURATION_BASED).

      Example:
      PER_PARTICIPANT
    • durationobject

      Default duration of the option.

      Child fields
      • daysinteger

        Whole days component.

        Example:
        0
      • hoursinteger

        Hours component.

        Example:
        1
      • minutesinteger

        Minutes component.

        Example:
        30
    • variantsobject[]

      The option's variants with their pricing tiers / participant prices.

    • addonsobject[]

      Add-ons purchasable with this option.

    • extraFieldsobject[]

      Custom booking questions configured on the option (extraFieldResponses answers reference these by id).

  • variantIdstring (uuid)

    UUID of the booked variant — references into the embedded option.variants.

    Example:
    1e2f3a4b-5c6d-4e7f-8a9b-0c1d2e3f4a5b
  • availabilitySlotIdstring (uuid)

    UUID of the booked availability slot.

    Example:
    2f3a4b5c-6d7e-4f8a-9b0c-1d2e3f4a5b6c
  • orderIdstring (uuid)

    UUID of the order (cart) the booking belongs to.

    Example:
    3a4b5c6d-7e8f-4a9b-0c1d-2e3f4a5b6c7d
  • redeemedRetailItemIdstring (uuid)nullable

    The gift voucher's retail item this booking is redeemed with, or null.

    Example:
    6c7d8e9f-0a1b-4c2d-8e3f-4a5b6c7d8e9f
  • timestring (date-time)

    Booking start as an absolute UTC timestamp (computed from the local slot time and the experience timezone).

    Example:
    2026-07-14T08:00:00Z
  • slotStartTimeobject

    Booking start in the experience's local timezone.

    Child fields
    • datestring (date)

      Local calendar date (YYYY-MM-DD).

      Example:
      2026-07-14
    • timestringnullable

      Local wall-clock time (HH:MM:SS). Null for date-only (all-day) slots.

      Example:
      10:00:00
  • slotEndTimeobjectnullable

    Booking occupancy end (local). Derived from the resolved resource window when resources are assigned (cleanup buffers excluded), otherwise start + bookedDuration. Null when neither is known (e.g. an all-day date-only slot).

    Child fields
    • datestring (date)

      Local calendar date (YYYY-MM-DD).

      Example:
      2026-07-14
    • timestringnullable

      Local wall-clock time (HH:MM:SS). Null for date-only (all-day) slots.

      Example:
      10:00:00
  • participantCountsmap of integer

    Map of participant-type UUID → booked count.

  • totalParticipantsinteger

    Sum of participant counts, excluding capacity-exempt types (e.g. infants).

    Example:
    2
  • bookedDurationobjectnullable

    Total booked duration. For duration-based options this is durationIncrement × durationUnits; otherwise a snapshot of the option duration at booking time.

    Child fields
    • daysinteger

      Whole days component.

      Example:
      0
    • hoursinteger

      Hours component.

      Example:
      1
    • minutesinteger

      Minutes component.

      Example:
      30
  • durationUnitsintegernullable

    Number of duration-increment blocks booked. Null for non-DURATION_BASED options.

  • finalPriceobject

    Total retail price charged to the traveler (after discounts).

    Child fields
    • amountnumber

      Amount in major currency units.

      Example:
      100
    • currencystring

      ISO 4217 currency code.

      Example:
      EUR
  • basePriceobject

    Sum of the BASE lines of the price breakdown (before add-ons and discounts).

    Child fields
    • amountnumber

      Amount in major currency units.

      Example:
      100
    • currencystring

      ISO 4217 currency code.

      Example:
      EUR
  • netRateobject

    Organizer's payout amount (retail minus commission).

    Child fields
    • amountnumber

      Amount in major currency units.

      Example:
      100
    • currencystring

      ISO 4217 currency code.

      Example:
      EUR
  • retailPriceBreakdownobject[]nullable

    Line-by-line retail price breakdown (base lines, add-ons, discounts).

    Child fields
    • labelstring

      Human-readable line label, in the booking's language (e.g. a participant type or add-on name).

      Example:
      Adult
    • quantityinteger

      Number of units on this line.

      Example:
      2
    • unitPricenumber

      Per-unit price.

      Example:
      50
    • retailPriceobject

      Line total (unitPrice × quantity).

      Child fields
      • amountnumber

        Amount in major currency units.

        Example:
        100
      • currencystring

        ISO 4217 currency code.

        Example:
        EUR
    • typestring

      Line kind: BASE (participant/tier pricing), ADDON or DISCOUNT (negative).

      Allowed values:
      BASEADDONDISCOUNT
      Example:
      BASE
  • bookingAddonsobject[]

    Add-ons purchased with the booking.

    Child fields
    • addonIdstring (uuid)

      UUID of the option add-on.

      Example:
      7a8b9c0d-1e2f-4a3b-8c9d-0e1f2a3b4c5d
    • addonNamestring

      Add-on name, localized to the request language (falling back to the booking language).

      Example:
      Hotel transfer
    • quantityinteger

      Effective quantity booked. For per-person checkbox add-ons this is derived from the participant count.

      Example:
      2
    • pricestringnullable

      Per-unit add-on price as a decimal string. Null for free add-ons.

      Example:
      15.00
    • perPersonboolean

      Whether the add-on is priced per participant.

      Example:
      true
  • extraFieldResponsesmap of stringnullable

    Answers to the option's custom booking questions, keyed by extra-field UUID.

  • storeExtraFieldResponsesobjectnullable

    Answers to the store's checkout questions, keyed by question id; each value is a string, a boolean (checkbox) or null. The questions themselves are defined on the store config (checkout.questions), not on the option, and are answered once per order — every booking of an order carries the same map. Returned only to the booking's reseller; null for everyone else, organizer-side callers included.

  • alternativeSlotsobject[]nullable

    Alternative slots currently offered by the organizer (see the reject endpoint). Null when none are pending.

    Child fields
    • idstring (uuid)

      Availability-slot UUID — pass this to POST /v2/bookings/{id}/accept-alternative.

      Example:
      3c4d5e6f-7a8b-4c9d-0e1f-2a3b4c5d6e7f
    • startDatestring (date)

      Local start date of the offered slot.

      Example:
      2026-07-15
    • startTimestringnullable

      Local start time of the offered slot. Null for date-only slots.

      Example:
      14:00:00
  • resellerobject

    The selling partner, enriched with point-of-sale metadata captured at booking time (store, agent, hotel/room) when present.

    Child fields
    • namestring

      Reseller partner display name.

      Example:
      Hotel Adriatic
    • partnerIdstring

      Reseller's public partner ID.

      Example:
      hotel-adriatic
    • logostringnullable

      URL of the reseller's logo.

      Example:
      https://cdn.turneo.com/logos/hotel-adriatic.png
    • featureFlagsobject

      Feature flags enabled for this partner.

    • storeIdstring

      ID of the store (widget/website) the booking was made through. Only present when captured.

      Example:
      store-123
    • storeNamestring

      Display name of the store. Only present when captured.

      Example:
      Lobby Desk
    • storeSubdomainstring

      Subdomain of the store. Only present when captured.

      Example:
      lobby
    • agentNamestring

      Name of the concierge agent who made the booking. Only present when captured.

      Example:
      Marta
    • agentReferencestring

      Agent's own reference for the booking. Only present when captured.

      Example:
      AG-42
    • hotelNamestring

      Hotel name captured at booking time. Only present when captured.

      Example:
      Turneo Hotel
    • roomNumberstring

      Guest's room number captured at booking time. Only present when captured.

      Example:
      204
  • resellerReferencestringnullable

    Reseller's internal reference for the booking.

    Example:
    PMS-42
  • resellerPropertyobjectnullable

    The reseller's property (hotel) the booking is associated with. Null when not linked.

    Child fields
    • idstring (uuid)

      Property UUID.

      Example:
      5f6a7b8c-9d0e-4f1a-2b3c-4d5e6f7a8b9c
    • namestring

      Property display name.

      Example:
      Hotel Adriatic Split
    • locationobjectnullable

      Property location (address, city, country, coordinates).

    • partnerstringnullable

      Owning partner reference.

      Example:
      hotel-adriatic
    • parentPropertystring (uuid)nullable

      Parent property UUID for property hierarchies.

    • roomCountintegernullable

      Number of rooms at the property.

      Example:
      120
    • pmsIntegrationobjectnullable

      PMS connection summary. Null when the property has no PMS integration.

      Child fields
      • enabledboolean

        Whether the PMS integration is active.

        Example:
        true
      • providerstring

        PMS provider (e.g. Mews, Apaleo, Oracle Opera).

        Example:
        Mews
  • pmsBookingIdstringnullable

    Identifier of the booking in the hotel's PMS, when synced.

    Example:
    MEWS-778812
  • travelerInformationobjectnullable

    Main traveler contact details.

    Child fields
    • firstNamestring

      Traveler's first name.

      Example:
      Ada
    • lastNamestring

      Traveler's last name.

      Example:
      Lovelace
    • emailstring (email)

      Traveler's email address — used for all guest-facing emails (confirmations, tickets, review requests).

      Example:
      ada.lovelace@example.com
    • phonestring

      Traveler's phone number, international format recommended.

      Example:
      +385911234567
  • paymentobjectnullable

    How and whether the booking was paid.

    Child fields
    • processedBystringnullable

      Who collects the payment. TURNEO (Stripe via Turneo — the only kind eligible for automatic capture/refund), TURNEO_LINK (payment link), RESELLER_CONCIERGE, RESELLER_ROOM (charged to the hotel room), RESELLER_CARD, RESELLER_DEFERRED (pay on site, settled via invoicing), ORGANIZER, PMS_ROOM_CHARGE, RETAIL_VOUCHER (paid with a gift voucher; the booking is priced at 0 and status is FREE), or the deprecated RESELLER. Null when not yet determined.

      Allowed values:
      TURNEOTURNEO_LINKRESELLER_CONCIERGERESELLER_ROOMRESELLER_CARDRESELLER_DEFERREDORGANIZERPMS_ROOM_CHARGERETAIL_VOUCHERRESELLER
      Example:
      TURNEO
    • statusstring

      PAYMENT_PENDING, PAYMENT_COLLECTED, REFUNDED or FREE.

      Allowed values:
      PAYMENT_PENDINGPAYMENT_COLLECTEDREFUNDEDFREE
      Example:
      PAYMENT_COLLECTED
    • codestringnullable

      Payment reference code (e.g. gateway transaction reference). Often null.

      Example:
      ch_3PqX1...
  • meetingPointobjectnullable

    The pickup/meeting arrangement selected for this booking.

    Child fields
    • typestring

      CENTRAL_MEETING_POINT or HOTEL_PICKUP.

      Allowed values:
      CENTRAL_MEETING_POINTHOTEL_PICKUP
      Example:
      CENTRAL_MEETING_POINT
    • titlestring

      Display name of the meeting point.

      Example:
      Main square fountain
    • addressstring

      Street address of the meeting point.

      Example:
      1 Main Street, Split
    • descriptionstring

      Extra instructions for finding the meeting point.

      Example:
      Look for the red umbrella
    • timeBeforeStartinteger

      How many minutes before the experience start the traveler should arrive.

      Example:
      15
  • voucherobjectnullable

    Seller discount voucher applied to the booking (via the order voucher endpoints). Null when none was used.

    Child fields
    • codestring

      Voucher code.

      Example:
      SUMMER20
    • discountPercentinteger

      Percentage discount granted by the voucher.

      Example:
      20
  • discountobjectnullable

    Automatic discount applied at booking time. Null when no discount applied.

    Child fields
    • percentageAmountinteger

      Percentage discount applied.

      Example:
      10
    • typestring

      Discount kind, e.g. EARLY_BIRD or AVAILABILITY.

      Example:
      EARLY_BIRD
  • conciergeDiscountobjectnullable

    Ad-hoc discount applied by a concierge at checkout. Null when none applied.

  • reviewobjectnullable

    The booking's review (the accepted one if present, otherwise the first). Null when the booking has no reviews.

    Child fields
    • idstring (uuid)

      Review UUID.

      Example:
      8b9c0d1e-2f3a-4b4c-9d0e-1f2a3b4c5d6e
    • ratinginteger

      Star rating, 1–5.

      Example:
      5
    • reviewTextstringnullable

      Review text.

      Example:
      Great tour, amazing guide!
    • reviewTextOriginalstringnullable

      Original (untranslated) review text.

      Example:
      Great tour, amazing guide!
    • internalFeedbackstringnullable

      Private feedback for the organizer — never shown publicly.

      Example:
      Guide was excellent
    • tagsstring[]

      Names of tags attached to the review.

    • reviewerNamestringnullable

      Reviewer's display name; falls back to the traveler's first name.

      Example:
      Ada Lovelace
    • reviewDatestring

      Review date (YYYY-MM-DD, or the creation timestamp when no explicit date was given).

      Example:
      2026-07-01
    • sourcestring

      reseller when posted by the booking's reseller, otherwise other.

      Allowed values:
      resellerother
      Example:
      reseller
    • storeIdstringnullable

      Store the review was posted from (reseller-posted reviews only).

      Example:
      store-123
    • statusstring

      Moderation status: PENDING, ACCEPTED or REJECTED.

      Allowed values:
      PENDINGACCEPTEDREJECTED
      Example:
      ACCEPTED
    • insightfulnessScorenumbernullable

      AI-scored insightfulness of the review text.

      Example:
      0.82
  • resourcesobject[]

    Resources assigned to the booking (deduplicated — one entry per resource even across multiple time blocks).

    Child fields
    • idstring (uuid)

      Resource UUID.

      Example:
      3c4d5e6f-7a8b-4c9d-0e1f-2a3b4c5d6e7f
    • namestring

      Resource display name.

      Example:
      Padel court 1
    • colorstringnullable

      Display color used in calendar UIs.

      Example:
      #FF8800
    • typestringnullable

      Organizer-defined resource type.

      Example:
      COURT
  • bookingSourcestringnullable

    Identifier of the channel that created the booking (e.g. store widget, concierge hub).

    Example:
    experience-store
  • emailNotificationstring (email)[]nullable

    Extra email addresses notified about this booking.

  • metadataobjectnullable

    Arbitrary JSON metadata attached at creation (store/agent context, external provider IDs, ...).

  • languagestring

    Language code of the booking — used for guest-facing emails and localized names.

    Example:
    en
  • cancellationobjectnullable

    Cancellation details. Null unless the booking is CANCELLED.

    Child fields
    • cancelledBystring

      Who cancelled the booking.

      Allowed values:
      TravelerOrganizerResellerAdmin
      Example:
      Traveler
    • cancelledAtstring

      When the cancellation happened, as a naive local timestamp in the experience's timezone.

      Example:
      2026-07-10T14:30:00
    • cancelledReasonstringnullable

      Free-text reason supplied by the canceller.

      Example:
      Change of plans
    • cancellationFeeAmountnumber

      Fee retained from the traveler. 0 means a full refund; the full price means non-refundable.

      Example:
      25
    • cancellationFeeCurrencystring

      Currency of the cancellation fee (the booking's currency).

      Example:
      EUR
    • refundPercentagenumber

      The refund-policy tier percentage that was applied. Absent when the fee was forced to 0 (organizer cancel, or traveler cancel after alternatives were offered).

      Example:
      75
  • notesobjectnullable

    One note per author role. Null when the booking has no notes.

    Child fields
    • fromSellerstring

      Note written by the reseller (concierge).

      Example:
      Guest asked for a vegetarian lunch
    • fromOrganizerstring

      Note written by the organizer (e.g. a rejection reason).

      Example:
      Meet at the side entrance
    • fromTravelerstring

      Note left by the traveler.

      Example:
      We'll be 5 minutes late
  • createdAtstring (date-time)

    When the booking was created (UTC).

    Example:
    2026-06-30T09:12:00Z
  • updatedAtstring (date-time)

    When the booking was last modified (UTC).

    Example:
    2026-07-01T10:00:00Z
Response 200json
{
  "id": "0b7f5f7e-1234-4c56-89ab-4d5e6f7a8b9c",
  "bookingCode": "AC3F1TT2",
  "bookingStatus": "ACCEPTED",
  "experience": {
    "id": "9b2e6c7d-1f2a-4b3c-8d9e-0a1b2c3d4e5f",
    "name": {
      "en": "Split Old Town Walking Tour"
    },
    "location": {
      "city": "Split",
      "country": "Croatia"
    },
    "images": [
      {
        "url": "https://cdn.turneo.com/img/tour.jpg",
        "position": 0
      }
    ],
    "organizer": {
      "name": "Split Tours",
      "partnerId": "split-tours"
    },
    "refundPolicy": {
      "tiers": [
        {
          "hoursBeforeStart": 24,
          "refundPercentage": 100
        },
        {
          "hoursBeforeStart": 0,
          "refundPercentage": 0
        }
      ]
    },
    "cutOffTime": 2
  },
  "option": {
    "id": "0d9f4c1a-2b3c-4d5e-8f9a-0b1c2d3e4f5a",
    "name": {
      "en": "Morning departure"
    },
    "pricingModel": "PER_PARTICIPANT",
    "duration": {
      "days": 0,
      "hours": 1,
      "minutes": 30
    },
    "variants": [
      {}
    ],
    "addons": [
      {}
    ],
    "extraFields": [
      {}
    ]
  },
  "variantId": "1e2f3a4b-5c6d-4e7f-8a9b-0c1d2e3f4a5b",
  "availabilitySlotId": "2f3a4b5c-6d7e-4f8a-9b0c-1d2e3f4a5b6c",
  "orderId": "3a4b5c6d-7e8f-4a9b-0c1d-2e3f4a5b6c7d",
  "redeemedRetailItemId": "6c7d8e9f-0a1b-4c2d-8e3f-4a5b6c7d8e9f",
  "time": "2026-07-14T08:00:00Z",
  "slotStartTime": {
    "date": "2026-07-14",
    "time": "10:00:00"
  },
  "slotEndTime": {
    "date": "2026-07-14",
    "time": "10:00:00"
  },
  "participantCounts": {
    "6f7a8b9c-0d1e-4f2a-3b4c-5d6e7f8a9b0c": 2
  },
  "totalParticipants": 2,
  "bookedDuration": {
    "days": 0,
    "hours": 1,
    "minutes": 30
  },
  "durationUnits": null,
  "finalPrice": {
    "amount": 100,
    "currency": "EUR"
  },
  "basePrice": {
    "amount": 100,
    "currency": "EUR"
  },
  "netRate": {
    "amount": 100,
    "currency": "EUR"
  },
  "retailPriceBreakdown": [
    {
      "label": "Adult",
      "quantity": 2,
      "unitPrice": 50,
      "retailPrice": {
        "amount": 100,
        "currency": "EUR"
      },
      "type": "BASE"
    }
  ],
  "bookingAddons": [
    {
      "addonId": "7a8b9c0d-1e2f-4a3b-8c9d-0e1f2a3b4c5d",
      "addonName": "Hotel transfer",
      "quantity": 2,
      "price": "15.00",
      "perPerson": true
    }
  ],
  "extraFieldResponses": {
    "5d6e7f8a-9b0c-4d1e-2f3a-4b5c6d7e8f9a": "No allergies"
  },
  "storeExtraFieldResponses": {
    "0d2e4f6a-8b0c-4d2e-9f1a-3b5c7d9e1f2a": "Room 204",
    "7c8d9e0f-1a2b-4c3d-8e9f-0a1b2c3d4e5f": true
  },
  "alternativeSlots": [
    {
      "id": "3c4d5e6f-7a8b-4c9d-0e1f-2a3b4c5d6e7f",
      "startDate": "2026-07-15",
      "startTime": "14:00:00"
    }
  ],
  "reseller": {
    "name": "Hotel Adriatic",
    "partnerId": "hotel-adriatic",
    "logo": "https://cdn.turneo.com/logos/hotel-adriatic.png",
    "featureFlags": {},
    "storeId": "store-123",
    "storeName": "Lobby Desk",
    "storeSubdomain": "lobby",
    "agentName": "Marta",
    "agentReference": "AG-42",
    "hotelName": "Turneo Hotel",
    "roomNumber": "204"
  },
  "resellerReference": "PMS-42",
  "resellerProperty": {
    "id": "5f6a7b8c-9d0e-4f1a-2b3c-4d5e6f7a8b9c",
    "name": "Hotel Adriatic Split",
    "location": {
      "city": "Split",
      "country": "Croatia"
    },
    "partner": "hotel-adriatic",
    "parentProperty": null,
    "roomCount": 120,
    "pmsIntegration": {
      "enabled": true,
      "provider": "Mews"
    }
  },
  "pmsBookingId": "MEWS-778812",
  "travelerInformation": {
    "firstName": "Ada",
    "lastName": "Lovelace",
    "email": "ada.lovelace@example.com",
    "phone": "+385911234567"
  },
  "payment": {
    "processedBy": "TURNEO",
    "status": "PAYMENT_COLLECTED",
    "code": "ch_3PqX1..."
  },
  "meetingPoint": {
    "type": "CENTRAL_MEETING_POINT",
    "title": "Main square fountain",
    "address": "1 Main Street, Split",
    "description": "Look for the red umbrella",
    "timeBeforeStart": 15
  },
  "voucher": {
    "code": "SUMMER20",
    "discountPercent": 20
  },
  "discount": {
    "percentageAmount": 10,
    "type": "EARLY_BIRD"
  },
  "conciergeDiscount": null,
  "review": {
    "id": "8b9c0d1e-2f3a-4b4c-9d0e-1f2a3b4c5d6e",
    "rating": 5,
    "reviewText": "Great tour, amazing guide!",
    "reviewTextOriginal": "Great tour, amazing guide!",
    "internalFeedback": "Guide was excellent",
    "tags": [
      "guide",
      "value"
    ],
    "reviewerName": "Ada Lovelace",
    "reviewDate": "2026-07-01",
    "source": "reseller",
    "storeId": "store-123",
    "status": "ACCEPTED",
    "insightfulnessScore": 0.82
  },
  "resources": [
    {
      "id": "3c4d5e6f-7a8b-4c9d-0e1f-2a3b4c5d6e7f",
      "name": "Padel court 1",
      "color": "#FF8800",
      "type": "COURT"
    }
  ],
  "bookingSource": "experience-store",
  "emailNotification": [
    "concierge@hotel.example"
  ],
  "metadata": {
    "store_id": "store-123",
    "store_name": "Lobby Desk"
  },
  "language": "en",
  "cancellation": {
    "cancelledBy": "Traveler",
    "cancelledAt": "2026-07-10T14:30:00",
    "cancelledReason": "Change of plans",
    "cancellationFeeAmount": 25,
    "cancellationFeeCurrency": "EUR",
    "refundPercentage": 75
  },
  "notes": {
    "fromSeller": "Guest asked for a vegetarian lunch",
    "fromOrganizer": "Meet at the side entrance",
    "fromTraveler": "We'll be 5 minutes late"
  },
  "createdAt": "2026-06-30T09:12:00Z",
  "updatedAt": "2026-07-01T10:00:00Z"
}

Errors

400

Validation failed. Inspect errors[].field and errors[].code.

401

Missing or invalid X-API-Key header.

403

The API key is valid but not allowed to perform this action on this resource.

404

The resource does not exist or belongs to another partner (existence is not leaked across partners).

Error body
  • typestring

    Error class.

    Allowed values:
    validation_errorclient_errorserver_error
    Example:
    validation_error
  • errorsobject[]
    Child fields
    • codestring

      Machine-readable error code.

      Example:
      required
    • fieldstringnullable

      Offending field, or null/'general' for non-field errors.

      Example:
      startTime
    • messagestring

      Human-readable message.

      Example:
      This field is required.
Response 400json
{
  "type": "validation_error",
  "errors": [
    {
      "code": "required",
      "field": "startTime",
      "message": "This field is required."
    }
  ]
}