List bookings

GET/v2/bookings

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

Lists all bookings visible to the calling partner, newest start time first (default ordering -time). Resellers get bookings they sold, organizers get bookings on their experiences, BOTH partners get the union — there is no way to list another partner's bookings.

Results are paginated (page, page_size, default page size 50); pass nopagination=true to receive a plain array instead of the pagination envelope.

Filtering

Most filters accept comma-separated lists (e.g. bookingStatus=ACCEPTED,PENDING). The relative filters startTime, bookingCreated, bookingLastModified, finalRetailPrice and cancellationFeeAmount accept the modifiers [eq], [gt], [lt], [gte], [lte] appended to the parameter name (e.g. startTime[gte]=2026-07-01T00:00:00). Notes:

  • startTime filters compare local calendar dates — the value is truncated to YYYY-MM-DD and matched against the booking's local start date, so bookings do not drift across day boundaries between timezones.
  • finalRetailPrice / cancellationFeeAmount must be numeric; a non-numeric value is a 400. A cancellationFeeAmount bound only constrains CANCELLED bookings — non-cancelled bookings always pass it.
  • activeOn=YYYY-MM-DD is additive to startTime and matches every local day a multi-day/daily booking covers, not just its start day.
  • search is free text over booking id (exact UUID), booking code (case-insensitive exact), experience name, organizer name, reseller name, store name (contains) and traveler email (case-insensitive exact) / traveler full name (contains).
  • optionId is the v2 filter for the booked option; rateId is kept as a backward-compatible alias with identical behaviour.

Sorting uses ordering with time, createdAt or updatedAt (prefix with - for descending).

Requestbash
curl "https://api.turneo.co/v2/bookings" \
  -H "X-API-Key: <your-api-key>"

Query parameters

  • pageinteger

    Page number to return (1-based).

    Default:
    1
    Example:
    1
  • page_sizeinteger

    Number of bookings per page. Defaults to 50.

    Default:
    50
    Example:
    50
  • nopaginationboolean

    Set to true to disable pagination and return a plain array of bookings.

    Default:
    false
    Example:
    false
  • orderingstring

    Sort field: time, createdAt or updatedAt. Prefix with - for descending. Defaults to -time (newest start time first).

    Example:
    -time
  • bookingStatusstring

    Comma-separated list of booking statuses to include (e.g. ACCEPTED,PENDING).

    Example:
    ACCEPTED,PENDING
  • bookingSourcestring

    Comma-separated list of booking source identifiers (e.g. the widget/store that created the booking).

    Example:
    experience-store
  • organizerIdstring

    Comma-separated list of organizer partner IDs — bookings on those organizers' experiences.

    Example:
    org-partner-1
  • resellerIdstring

    Comma-separated list of reseller partner IDs — bookings sold by those resellers.

    Example:
    hotel-partner-1
  • guestIdstring

    Comma-separated list of guest UUIDs the bookings are linked to.

    Example:
    6a1f2f0e-3f6a-4a9a-9d8e-1c2b3a4d5e6f
  • paymentProcessedBystring

    Comma-separated list of payment collectors. Values: TURNEO, TURNEO_LINK, RESELLER_CONCIERGE, RESELLER_ROOM, RESELLER_CARD, RESELLER_DEFERRED, ORGANIZER, PMS_ROOM_CHARGE, RETAIL_VOUCHER (paid with a gift voucher), RESELLER (deprecated).

    Example:
    TURNEO,TURNEO_LINK
  • redeemedRetailItemIdstring (uuid)

    UUID of a gift voucher's retail item — returns the bookings redeemed with that voucher.

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

    Filter by payment status: PAYMENT_PENDING, PAYMENT_COLLECTED, REFUNDED or FREE.

    Example:
    PAYMENT_COLLECTED
  • optionIdstring

    Comma-separated list of option UUIDs the bookings were made on. Malformed UUIDs return a 400.

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

    Alias for optionId, kept for older integrations — prefer optionId. Malformed UUIDs return a 400.

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

    Comma-separated list of experience UUIDs.

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

    Comma-separated list of experience category types (e.g. Wellness). Matched on the booked experience's categories.type.

    Example:
    Wellness
  • storeIdstring

    Comma-separated list of store IDs (matched against booking metadata).

    Example:
    store-123
  • resourceIdstring

    Comma-separated list of resource UUIDs — bookings holding a block on any of those resources. Malformed UUIDs return a 400.

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

    Comma-separated list of short booking codes (exact match).

    Example:
    AC3F1TT2
  • resellerReferencestring

    Reseller's internal reference (contains, case-insensitive).

    Example:
    PMS-42
  • travelerEmailstring

    Traveler email (exact match, case-insensitive).

    Example:
    ada.lovelace@example.com
  • agentNamestring

    One agent name or a comma-separated list of exact agent names stored on booking metadata.

    Example:
    Iva,Marta
  • organizerPropertyIdstring (uuid)

    Property UUID associated with the experience (organizer side).

    Example:
    5f6a7b8c-9d0e-4f1a-2b3c-4d5e6f7a8b9c
  • resellerPropertyIdstring (uuid)

    Property UUID the booking was sold at (reseller side).

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

    true returns only bookings with at least one review; false only bookings without reviews.

    Example:
    true
  • reviewStatusstring

    Comma-separated review statuses: PENDING, ACCEPTED, REJECTED.

    Example:
    ACCEPTED
  • reviewSourcestring

    Comma-separated review sources.

    Example:
    reseller
  • reviewRatingstring

    Comma-separated integer ratings (1–5).

    Example:
    4,5
  • reviewTextstring

    Review text search (contains, case-insensitive).

    Example:
    amazing guide
  • reviewFromstring (date)

    Reviews dated on or after this date (YYYY-MM-DD).

    Example:
    2026-06-01
  • reviewUntilstring (date)

    Reviews dated on or before this date (YYYY-MM-DD, inclusive of the whole day).

    Example:
    2026-06-30
  • searchstring

    Free-text search across booking id (exact UUID), booking code (exact, case-insensitive), experience name, organizer name, reseller name, store name (contains) and traveler email (exact, case-insensitive) / traveler full name (all words must match).

    Example:
    Ada Lovelace
  • activeOnstring (date)

    Local date (YYYY-MM-DD). Returns bookings whose occupied span (start date through computed end date, mode-aware for multi-day rentals) overlaps that day. Additive to startTime filters. Malformed dates return a 400.

    Example:
    2026-07-14
  • startTime[gte]string

    Bookings starting on or after this local date. The value is truncated to YYYY-MM-DD and compared against the booking's local start date. Also supports [lte], [gt], [lt], [eq].

    Example:
    2026-07-01T00:00:00
  • startTime[lte]string

    Bookings starting on or before this local date (truncated to YYYY-MM-DD).

    Example:
    2026-07-31T23:59:59
  • bookingCreated[gte]string (date-time)

    Bookings created at or after this timestamp. Also supports [lte], [gt], [lt], [eq].

    Example:
    2026-06-01T00:00:00Z
  • bookingLastModified[gte]string (date-time)

    Bookings last modified at or after this timestamp. Also supports [lte], [gt], [lt], [eq].

    Example:
    2026-06-15T00:00:00Z
  • finalRetailPrice[gte]number

    Bookings with a final price greater than or equal to this numeric amount. Also supports [lte], [gt], [lt], [eq]. Non-numeric values return a 400.

    Example:
    100
  • cancellationFeeAmount[gte]number

    Constrains the cancellation fee of CANCELLED bookings (non-cancelled bookings always pass). Also supports [lte], [gt], [lt], [eq]. Non-numeric values return a 400.

    Example:
    1

Responses

200object

Paginated list of bookings. Each result embeds its full experience and option objects.

  • countinteger

    Total number of bookings matching the filters, across all pages.

    Example:
    137
  • nextstringnullable

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

    Example:
    https://api.turneo.co/v2/bookings?page=2&page_size=50
  • previousstringnullable

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

  • resultsobject[]

    The bookings on this page.

    Child fields
    • 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
{
  "count": 137,
  "next": "https://api.turneo.co/v2/bookings?page=2&page_size=50",
  "previous": null,
  "results": [
    {
      "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.

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