List booking orders

GET/v2/booking-orders

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

Returns a paginated list of v2 booking orders you created, newest first (-createdAt). Soft-deleted orders (see DELETE /v2/booking-orders/{id}) are excluded.

Filtering

  • status — comma-separated derived order statuses. An order is ON_HOLD only when it has at least one ON_HOLD booking and nothing has progressed to a booked state; BOOKED when any booking is ACCEPTED/PENDING/COMPLETED/CANCELLED; EXPIRED only when nothing on the order is alive. Unknown status values return a 400 listing the allowed values.
  • search — free-text, whitespace-tokenized; every token must match. Each token is matched (case-insensitive, partial) against the experience name (in the request language, with an en fallback), the order-level traveler first/last name, and each booking's traveler first/last name. A token that parses as a UUID additionally matches the order id exactly.
  • viaPaymentLink — true returns orders where any booking's payment carries viaPaymentLink: true; false returns everything else (including bookings where the key is absent).
Requestbash
curl "https://api.turneo.co/v2/booking-orders" \
  -H "X-API-Key: <your-api-key>"

Query parameters

  • pageinteger

    Page number to return (1-based).

    Default:
    1
    Example:
    1
  • page_sizeinteger

    Number of orders per page (default 50).

    Default:
    50
    Example:
    50
  • nopaginationboolean

    When true, disables pagination and returns all matching orders in a plain array.

    Example:
    false
  • statusstring

    Comma-separated list of derived order statuses to include. Allowed values: ON_HOLD, BOOKED, EXPIRED. Any other value returns a 400.

    Example:
    ON_HOLD,BOOKED
  • searchstring

    Free-text search. Tokens are ANDed and matched against experience names, order and booking traveler names, and (for UUID-shaped tokens) the order id.

    Example:
    Kayak Alice
  • viaPaymentLinkboolean

    Filter by payment-link orders. true matches orders with at least one booking whose payment has viaPaymentLink: true; false matches all others.

    Example:
    true

Responses

200object

Paginated list of orders.

  • countinteger

    Total number of orders matching the query.

    Example:
    42
  • nextstring (uri)nullable

    URL of the next page, or null on the last page.

    Example:
    https://api.turneo.co/v2/booking-orders?page=2&page_size=50
  • previousstring (uri)nullable

    URL of the previous page, or null on the first page.

  • resultsobject[]

    Orders on this page, newest first.

    Child fields
    • idstring (uuid)

      Order UUID.

      Example:
      0f47ac10-b58c-4372-a567-0e02b2c3d479
    • statusstring

      Derived order status, counting bookings and retail lines alike. ON_HOLD — all active lines are still on hold; BOOKED — at least one line progressed past ON_HOLD; EXPIRED — the order has lines but none are active.

      Allowed values:
      ON_HOLDBOOKEDEXPIRED
      Example:
      ON_HOLD
    • travelerInformationobjectnullable

      Traveler contact information shared by the bookings in the order. Individual bookings may carry their own traveler information which takes precedence.

      Child fields
      • emailstring (email)

        Traveler's email address — used for confirmation, ticket and payment-link emails.

        Example:
        guest@example.com
      • firstNamestringnullable

        Traveler's first name.

        Example:
        Alice
      • lastNamestringnullable

        Traveler's last name.

        Example:
        Smith
      • phonestringnullable

        Traveler's phone number in international format.

        Example:
        +385911234567
    • bookingsobject[]

      The order's bookings, newest first. EXPIRED and REMOVED bookings are excluded — unless every non-removed booking has expired, in which case the EXPIRED bookings are returned so the dead cart can be rendered.

      Child fields
      • idstring (uuid)

        Booking UUID.

        Example:
        7d1e2f3a-4b5c-4d6e-8f9a-0b1c2d3e4f5a
      • bookingCodestring

        Short human-readable booking code used on tickets and folios.

        Example:
        TRN-8F3K2A
      • bookingStatusstring

        Booking lifecycle status. ON_HOLD (reserved, 15-minute hold), PENDING (confirmed, awaiting organizer acceptance), ACCEPTED (live), COMPLETED, CANCELLED, EXPIRED (hold or organizer-response timer ran out), NO_SHOW, REJECTED, REMOVED (taken out of the cart).

        Allowed values:
        ON_HOLDPENDINGACCEPTEDCOMPLETEDCANCELLEDEXPIREDNO_SHOWREJECTEDREMOVED
        Example:
        ON_HOLD
      • experienceobjectnullable

        Full embedded experience object (id, name, images, location, duration, refund policy, organizer...). Shape matches the v2 experience read schema.

      • optionobjectnullable

        Full embedded option object including its variants (with pricing tiers and participant prices), add-ons and extra fields. Shape matches the v2 option read schema.

      • variantIdstring (uuid)

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

        Example:
        3f2e6d1c-8a4b-4f0e-9c7d-2b1a0e9f8d7c
      • availabilitySlotIdstring (uuid)

        UUID of the booked availability slot.

        Example:
        9b8a7c6d-5e4f-4a3b-8c2d-1e0f9a8b7c6d
      • orderIdstring (uuid)

        UUID of the parent order.

        Example:
        0f47ac10-b58c-4372-a567-0e02b2c3d479
      • redeemedRetailItemIdstring (uuid)nullable

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

        Example:
        6c7d8e9f-0a1b-4c2d-8e3f-4a5b6c7d8e9f
      • slotStartTimeobjectnullable

        A local date/time pair in the experience's timezone.

        Child fields
        • datestring (date)nullable

          Local date (YYYY-MM-DD).

          Example:
          2026-07-10
        • timestringnullable

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

          Example:
          10:00:00
      • slotEndTimeobjectnullable

        Booking occupancy end in local time — derived from the resolved resource-block window when present, otherwise start + bookedDuration. Null for all-day date-only slots.

        Child fields
        • datestring (date)nullable

          Local date (YYYY-MM-DD).

          Example:
          2026-07-10
        • timestringnullable

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

          Example:
          10:00:00
      • timestring (date-time)nullable

        Booking start as a UTC timestamp.

        Example:
        2026-07-10T08:00:00Z
      • participantCountsmap of integer

        Map of participant-type UUID to booked head count.

      • totalParticipantsinteger

        Total booked participants across all participant types.

        Example:
        2
      • bookedDurationobject

        Booked duration as {days, hours, minutes}, computed from the option configuration.

      • durationUnitsintegernullable

        Number of duration-increment blocks booked. Only set for DURATION_BASED pricing.

        Example:
        2
      • retailPriceBreakdownobject[]

        Line-by-line retail price breakdown (one entry per participant type, add-on and discount) with label, quantity and price.

      • bookingAddonsobject[]

        Booked add-ons with resolved names and effective quantities.

        Child fields
        • addonIdstring (uuid)

          Add-on UUID.

          Example:
          5a4b3c2d-1e0f-4a9b-8c7d-6e5f4a3b2c1d
        • addonNamestring

          Add-on name in the request language.

          Example:
          Hotel transfer
        • quantityinteger

          Effective booked quantity (server-derived for per-person checkbox add-ons).

          Example:
          2
        • pricestringnullable

          Unit price of the add-on as a decimal string.

          Example:
          15.00
        • perPersonboolean

          Whether the add-on is priced per person.

          Example:
          true
      • extraFieldResponsesmap of stringnullable

        Map of extra-field UUID to the traveler's answer.

      • 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 offered by the organizer on a PENDING booking, or null when none were offered.

        Child fields
        • idstring (uuid)

          Alternative slot UUID.

          Example:
          2b3c4d5e-6f7a-4b8c-9d0e-1f2a3b4c5d6e
        • startDatestring (date)nullable

          Local start date of the alternative slot.

          Example:
          2026-07-11
        • startTimestringnullable

          Local start time of the alternative slot.

          Example:
          14:00:00
      • resellerobject

        Embedded reseller partner (id, name, logo...) enriched with attribution from the booking metadata — storeId, storeName, storeSubdomain, agentName, agentReference, hotelName, roomNumber — when present.

      • finalPriceobject

        Total retail price the traveler pays for this booking.

        Child fields
        • amountnumber

          Amount in major currency units.

          Example:
          250
        • currencystring

          ISO 4217 currency code.

          Example:
          EUR
      • basePriceobject

        Base (pre-commission) price of the booking.

        Child fields
        • amountnumber

          Amount in major currency units.

          Example:
          250
        • currencystring

          ISO 4217 currency code.

          Example:
          EUR
      • netRateobject

        Organizer's payout amount for this booking.

        Child fields
        • amountnumber

          Amount in major currency units.

          Example:
          250
        • currencystring

          ISO 4217 currency code.

          Example:
          EUR
      • discountobjectnullable

        Automatic slot/option discount applied at booking time, or null.

      • voucherobjectnullable

        Applied voucher details (code, discount), or null when no voucher is applied.

      • conciergeDiscountobjectnullable

        Manually applied concierge discount (amount, note), or null.

      • paymentobjectnullable

        Payment details for one booking.

        Child fields
        • codestringnullable

          Payment reference — e.g. a Stripe payment-intent id, sent by the client at confirm time.

          Example:
          pi_3OqX8s2eZvKYlo2C
        • statusstring

          Payment status.

          Allowed values:
          PAYMENT_PENDINGPAYMENT_COLLECTEDREFUNDEDFREE
          Example:
          PAYMENT_COLLECTED
        • processedBystringnullable

          Who collects the money. TURNEO (Stripe via Turneo — the only type eligible for auto-capture), TURNEO_LINK (payment link), RESELLER_CONCIERGE / RESELLER_ROOM / RESELLER_CARD (reseller collects), PMS_ROOM_CHARGE, ORGANIZER, or RETAIL_VOUCHER (paid with a gift voucher; to redeem one, send it in the order-level payment at confirm, with the voucher code as code).

          Example:
          TURNEO
        • viaPaymentLinkboolean

          Present and true when the payment was initiated through a payment link.

          Example:
          false
      • travelerInformationobjectnullable

        Booking-level traveler info. Inherited from the order at confirm time when not set.

        Child fields
        • emailstring (email)

          Traveler's email address — used for confirmation, ticket and payment-link emails.

          Example:
          guest@example.com
        • firstNamestringnullable

          Traveler's first name.

          Example:
          Alice
        • lastNamestringnullable

          Traveler's last name.

          Example:
          Smith
        • phonestringnullable

          Traveler's phone number in international format.

          Example:
          +385911234567
      • meetingPointobjectnullable

        Resolved meeting point / pickup details for the booking.

      • resellerReferencestringnullable

        Reseller's internal reference for this booking.

        Example:
        HOTEL-4711
      • resellerPropertyobjectnullable

        The reseller property (hotel) the booking is attributed to — id, name, location, partner, parentProperty, roomCount and a pmsIntegration summary — or null.

      • pmsBookingIdstringnullable

        External PMS reservation id linked to this booking (e.g. Valamar master id).

        Example:
        123456789
      • bookingSourcestringnullable

        Source identifier of the sales channel that created the booking.

        Example:
        hub
      • emailNotificationstring (email)[]nullable

        Extra email addresses notified about this booking.

      • metadataobjectnullable

        Arbitrary attribution metadata (store/agent details, external provider ids).

      • languagestring

        Language code used for traveler-facing communication.

        Example:
        en
      • cancellationobjectnullable

        Cancellation details (cancelledBy, cancelledAt, cancellationFeeAmount), or null.

      • reviewobjectnullable

        The booking's review (rating, reviewText, status...), or null when not reviewed.

      • resourcesobject[]

        Resources (guides, vehicles) assigned to the booking, deduplicated.

        Child fields
        • idstring (uuid)

          Resource UUID.

          Example:
          8c7d6e5f-4a3b-4c2d-9e1f-0a9b8c7d6e5f
        • namestring

          Resource display name.

          Example:
          Kayak guide Ivan
      • notesobjectnullable

        Booking notes keyed by author — fromSeller, fromOrganizer, fromTraveler. Null when empty.

      • createdAtstring (date-time)

        When the booking was created.

        Example:
        2026-07-02T09:15:00Z
      • updatedAtstring (date-time)

        When the booking was last modified.

        Example:
        2026-07-02T09:20:00Z
    • retailItemsobject[]

      The order's retail and gift voucher lines, newest first, selected like bookings: EXPIRED and REMOVED lines are excluded unless the whole order has expired. voucherCode is always null here; the gift voucher code is emailed to its holder.

      Child fields
      • idstring (uuid)

        Line UUID.

        Example:
        7d1e2f3a-4b5c-4d6e-8f9a-0b1c2d3e4f5a
      • orderIdstring (uuid)

        UUID of the order the line belongs to.

        Example:
        0f47ac10-b58c-4372-a567-0e02b2c3d479
      • retailCodestring

        Short reference for the line (10 characters). Usable in place of the UUID in /v2/retail-items/{id} and as a filter. It is not a gift voucher code.

        Example:
        3HCX9KPT2L
      • retailSkuIdstring (uuid)

        UUID of the purchased SKU.

        Example:
        8f14e45f-ceea-4e5b-b0d4-9f3c1a2b3c4d
      • skuCodestringnullable

        The purchased SKU's stock-keeping code.

        Example:
        TSHIRT-RED-M
      • experienceIdstring (uuid)

        UUID of the retail product.

        Example:
        0d4dbb2e-8a51-4a4b-9d3e-6f2b7c1a9e55
      • experienceobject

        The retail product, in the experience read shape without the fields that only bookable experiences have (options, participant types, meeting points, booking type).

      • quantityinteger

        Units bought. Always 1 on a gift voucher line.

        Example:
        2
      • imageUrlstring (uri)nullable

        The SKU's image, or the product's first image when the SKU has none.

        Example:
        https://images.example.com/tshirt-red.jpg
      • variantLabelsstring[]

        Labels of the purchased SKU's variation values, in axis order, in the line's language. Empty for a product without variations.

      • finalPriceobject

        What the buyer pays for the line (unit price times quantity, minus any concierge discount).

        Child fields
        • amountnumber

          Amount in major currency units.

          Example:
          250
        • currencystring

          ISO 4217 currency code.

          Example:
          EUR
      • netRateobject

        What the product's organizer receives for the line (line total minus commission).

        Child fields
        • amountnumber

          Amount in major currency units.

          Example:
          250
        • currencystring

          ISO 4217 currency code.

          Example:
          EUR
      • statusstring

        ON_HOLD while the order is unconfirmed; PAID once it is confirmed; DELIVERED after you mark it delivered; CANCELLED after a cancellation. EXPIRED means the order's hold ran out, REMOVED that the line was taken out of the order.

        Allowed values:
        ON_HOLDPAIDDELIVEREDCANCELLEDEXPIREDREMOVED
        Example:
        PAID
      • paidAtstring (date-time)nullable

        When the order was confirmed. Retail has no service date, so reporting uses this.

        Example:
        2026-07-15T09:12:00Z
      • paymentobjectnullable

        Payment details for one booking.

        Child fields
        • codestringnullable

          Payment reference — e.g. a Stripe payment-intent id, sent by the client at confirm time.

          Example:
          pi_3OqX8s2eZvKYlo2C
        • statusstring

          Payment status.

          Allowed values:
          PAYMENT_PENDINGPAYMENT_COLLECTEDREFUNDEDFREE
          Example:
          PAYMENT_COLLECTED
        • processedBystringnullable

          Who collects the money. TURNEO (Stripe via Turneo — the only type eligible for auto-capture), TURNEO_LINK (payment link), RESELLER_CONCIERGE / RESELLER_ROOM / RESELLER_CARD (reseller collects), PMS_ROOM_CHARGE, ORGANIZER, or RETAIL_VOUCHER (paid with a gift voucher; to redeem one, send it in the order-level payment at confirm, with the voucher code as code).

          Example:
          TURNEO
        • viaPaymentLinkboolean

          Present and true when the payment was initiated through a payment link.

          Example:
          false
      • cancellationobjectnullable

        Cancellation details (cancelledBy, cancelledAt in UTC, cancelledReason, cancellationFeeAmount, cancellationFeeCurrency). Null unless the line 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
      • resellerobjectnullable

        The selling partner, enriched with the store and agent attribution captured at checkout.

      • resellerPropertyobjectnullable

        The property (hotel) the sale is attributed to, or null.

      • languagestringnullable

        Language of the buyer's checkout, used for emails and labels.

        Example:
        en
      • travelerInformationobjectnullable

        The buyer's details, from the order. Retail lines have no traveler of their own.

        Child fields
        • emailstring (email)

          Traveler's email address — used for confirmation, ticket and payment-link emails.

          Example:
          guest@example.com
        • firstNamestringnullable

          Traveler's first name.

          Example:
          Alice
        • lastNamestringnullable

          Traveler's last name.

          Example:
          Smith
        • phonestringnullable

          Traveler's phone number in international format.

          Example:
          +385911234567
      • conciergeDiscountobjectnullable

        Discount applied to the line at checkout, as {amount, currency, note}, or null.

      • allowedUsesintegernullable

        Total uses a gift voucher line grants. Null on other lines.

        Example:
        5
      • remainingUsesintegernullable

        Uses a gift voucher line has left; 0 unless the line is PAID. Null on other lines.

        Example:
        3
      • voucherCodestringnullable

        The gift voucher code. Returned only by the /v2/retail-items endpoints, so the buyer of a gift never sees it on the order; the holder receives it by email. Null on other lines.

        Example:
        7WF4MRY2KC8N
      • recipientEmailstring (email)nullable

        Gift recipient of a voucher. The voucher email goes here instead of to the buyer.

        Example:
        recipient@guest.example
      • recipientNamestringnullable

        Name of the gift recipient.

        Example:
        Alex Example
      • extraFieldResponsesobjectnullable

        The buyer's answers to the SKU's questions, keyed by question UUID.

      • createdAtstring (date-time)

        When the line was added to the order.

        Example:
        2026-07-15T09:05:00Z
    • finalPriceobject

      Sum of the final prices of the displayed bookings and retail lines, excluding refunded ones. Currency comes from the first booking (or retail line); defaults to the platform currency with amount 0 for an empty order.

      Child fields
      • amountnumber

        Amount in major currency units.

        Example:
        250
      • currencystring

        ISO 4217 currency code.

        Example:
        EUR
    • basePricenumber

      Sum of the base (net-rate) prices of the displayed bookings and retail lines, rounded to 2 decimals.

      Example:
      200
    • resellerReferencestringnullable

      Reseller's internal order reference.

      Example:
      HOTEL-4711
    • emailNotificationstring (email)[]nullable

      Email addresses to notify about the order; inherited by bookings without their own list.

    • bookingSourcestringnullable

      Source identifier of the sales channel (e.g. store subdomain, "hub").

      Example:
      hub
    • utmMediumstringnullable

      UTM medium tracking parameter captured at checkout.

      Example:
      email
    • utmSourcestringnullable

      UTM source tracking parameter captured at checkout.

      Example:
      newsletter
    • storeobject

      Store attribution derived from the first booking's metadata. All fields are null when the order was not placed through a store.

      Child fields
      • idstringnullable

        Store identifier (MongoDB id) the order was placed through.

        Example:
        64f1a2b3c4d5e6f7a8b9c0d1
      • subdomainstringnullable

        Store subdomain.

        Example:
        hotel-adriatic
      • namestringnullable

        Store display name.

        Example:
        Hotel Adriatic Experiences
    • storeExtraFieldResponsesobjectnullable

      Answers to the store's checkout questions, keyed by question id; each value is a string, a boolean (checkbox) or null. The questions are defined on the store config (checkout.questions). Empty ({}) once the checkout form has been submitted with no answers — a store with no questions, or a clear — and null only for orders that never went through it: those created before this shipped, or by a client that never sends the key. Unlike the booking-level copy this is ungated — the order endpoints are already scoped to the order's creator/reseller, and checkout reads its own answers back to re-seed the form.

    • createdAtstring (date-time)

      When the order was created.

      Example:
      2026-07-02T09:15:00Z
    • updatedAtstring (date-time)

      When the order was last modified.

      Example:
      2026-07-02T09:20:00Z
Response 200json
{
  "count": 42,
  "next": "https://api.turneo.co/v2/booking-orders?page=2&page_size=50",
  "previous": null,
  "results": [
    {
      "id": "0f47ac10-b58c-4372-a567-0e02b2c3d479",
      "status": "ON_HOLD",
      "travelerInformation": {
        "email": "guest@example.com",
        "firstName": "Alice",
        "lastName": "Smith",
        "phone": "+385911234567"
      },
      "bookings": [
        {
          "id": "7d1e2f3a-4b5c-4d6e-8f9a-0b1c2d3e4f5a",
          "bookingCode": "TRN-8F3K2A",
          "bookingStatus": "ON_HOLD",
          "experience": {},
          "option": {},
          "variantId": "3f2e6d1c-8a4b-4f0e-9c7d-2b1a0e9f8d7c",
          "availabilitySlotId": "9b8a7c6d-5e4f-4a3b-8c2d-1e0f9a8b7c6d",
          "orderId": "0f47ac10-b58c-4372-a567-0e02b2c3d479",
          "redeemedRetailItemId": "6c7d8e9f-0a1b-4c2d-8e3f-4a5b6c7d8e9f",
          "slotStartTime": {
            "date": "2026-07-10",
            "time": "10:00:00"
          },
          "slotEndTime": {
            "date": "2026-07-10",
            "time": "10:00:00"
          },
          "time": "2026-07-10T08:00:00Z",
          "participantCounts": {
            "c1a2b3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d": 2
          },
          "totalParticipants": 2,
          "bookedDuration": {
            "days": 0,
            "hours": 2,
            "minutes": 0
          },
          "durationUnits": 2,
          "retailPriceBreakdown": [
            {
              "label": "Adult",
              "quantity": 2,
              "price": 50,
              "type": "PARTICIPANT"
            }
          ],
          "bookingAddons": [
            {
              "addonId": "5a4b3c2d-1e0f-4a9b-8c7d-6e5f4a3b2c1d",
              "addonName": "Hotel transfer",
              "quantity": 2,
              "price": "15.00",
              "perPerson": true
            }
          ],
          "extraFieldResponses": {
            "aa1bb2cc-3dd4-4ee5-9ff6-0a1b2c3d4e5f": "Vegetarian"
          },
          "storeExtraFieldResponses": {
            "0d2e4f6a-8b0c-4d2e-9f1a-3b5c7d9e1f2a": "Room 204",
            "7c8d9e0f-1a2b-4c3d-8e9f-0a1b2c3d4e5f": true
          },
          "alternativeSlots": [
            {
              "id": "2b3c4d5e-6f7a-4b8c-9d0e-1f2a3b4c5d6e",
              "startDate": "2026-07-11",
              "startTime": "14:00:00"
            }
          ],
          "reseller": {
            "id": "1a2b3c4d-5e6f-4a7b-8c9d-0e1f2a3b4c5d",
            "name": "Hotel Adriatic",
            "storeId": "64f1a2b3c4d5e6f7a8b9c0d1",
            "storeName": "Hotel Adriatic Experiences"
          },
          "finalPrice": {
            "amount": 250,
            "currency": "EUR"
          },
          "basePrice": {
            "amount": 250,
            "currency": "EUR"
          },
          "netRate": {
            "amount": 250,
            "currency": "EUR"
          },
          "discount": {},
          "voucher": {},
          "conciergeDiscount": {},
          "payment": {
            "code": "pi_3OqX8s2eZvKYlo2C",
            "status": "PAYMENT_COLLECTED",
            "processedBy": "TURNEO",
            "viaPaymentLink": false
          },
          "travelerInformation": {
            "email": "guest@example.com",
            "firstName": "Alice",
            "lastName": "Smith",
            "phone": "+385911234567"
          },
          "meetingPoint": {
            "type": "CENTRAL_MEETING_POINT",
            "title": "Old Town Gate",
            "address": "1 Main St",
            "timeBeforeStart": 15
          },
          "resellerReference": "HOTEL-4711",
          "resellerProperty": {},
          "pmsBookingId": "123456789",
          "bookingSource": "hub",
          "emailNotification": [
            "concierge@hotel.com"
          ],
          "metadata": {},
          "language": "en",
          "cancellation": {},
          "review": {},
          "resources": [
            {
              "id": "8c7d6e5f-4a3b-4c2d-9e1f-0a9b8c7d6e5f",
              "name": "Kayak guide Ivan"
            }
          ],
          "notes": {
            "fromSeller": "Guest is celebrating an anniversary."
          },
          "createdAt": "2026-07-02T09:15:00Z",
          "updatedAt": "2026-07-02T09:20:00Z"
        }
      ],
      "retailItems": [
        {
          "id": "7d1e2f3a-4b5c-4d6e-8f9a-0b1c2d3e4f5a",
          "orderId": "0f47ac10-b58c-4372-a567-0e02b2c3d479",
          "retailCode": "3HCX9KPT2L",
          "retailSkuId": "8f14e45f-ceea-4e5b-b0d4-9f3c1a2b3c4d",
          "skuCode": "TSHIRT-RED-M",
          "experienceId": "0d4dbb2e-8a51-4a4b-9d3e-6f2b7c1a9e55",
          "experience": {},
          "quantity": 2,
          "imageUrl": "https://images.example.com/tshirt-red.jpg",
          "variantLabels": [
            "Red",
            "M"
          ],
          "finalPrice": {
            "amount": 250,
            "currency": "EUR"
          },
          "netRate": {
            "amount": 250,
            "currency": "EUR"
          },
          "status": "PAID",
          "paidAt": "2026-07-15T09:12:00Z",
          "payment": {
            "code": "pi_3OqX8s2eZvKYlo2C",
            "status": "PAYMENT_COLLECTED",
            "processedBy": "TURNEO",
            "viaPaymentLink": false
          },
          "cancellation": {
            "cancelledBy": "Traveler",
            "cancelledAt": "2026-07-10T14:30:00",
            "cancelledReason": "Change of plans",
            "cancellationFeeAmount": 25,
            "cancellationFeeCurrency": "EUR",
            "refundPercentage": 75
          },
          "reseller": {},
          "resellerProperty": {},
          "language": "en",
          "travelerInformation": {
            "email": "guest@example.com",
            "firstName": "Alice",
            "lastName": "Smith",
            "phone": "+385911234567"
          },
          "conciergeDiscount": null,
          "allowedUses": 5,
          "remainingUses": 3,
          "voucherCode": "7WF4MRY2KC8N",
          "recipientEmail": "recipient@guest.example",
          "recipientName": "Alex Example",
          "extraFieldResponses": {
            "aa1bb2cc-3dd4-4ee5-9ff6-0a1b2c3d4e5f": "Happy birthday!"
          },
          "createdAt": "2026-07-15T09:05:00Z"
        }
      ],
      "finalPrice": {
        "amount": 250,
        "currency": "EUR"
      },
      "basePrice": 200,
      "resellerReference": "HOTEL-4711",
      "emailNotification": [
        "concierge@hotel.com"
      ],
      "bookingSource": "hub",
      "utmMedium": "email",
      "utmSource": "newsletter",
      "store": {
        "id": "64f1a2b3c4d5e6f7a8b9c0d1",
        "subdomain": "hotel-adriatic",
        "name": "Hotel Adriatic Experiences"
      },
      "storeExtraFieldResponses": {
        "0d2e4f6a-8b0c-4d2e-9f1a-3b5c7d9e1f2a": "Room 204",
        "7c8d9e0f-1a2b-4c3d-8e9f-0a1b2c3d4e5f": true
      },
      "createdAt": "2026-07-02T09:15:00Z",
      "updatedAt": "2026-07-02T09:20:00Z"
    }
  ]
}

Errors

400

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

401

Missing or invalid X-API-Key header.

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."
    }
  ]
}