> ## Documentation Index
> Fetch the complete documentation index at: https://docs.way.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Get booking details by cart

> Returns a cart's purchaser and booking context, typically read after payment confirmation.



## OpenAPI

````yaml get /v1/carts/{cartId}
openapi: 3.0.0
info:
  title: Way Partner API
  description: >-
    REST API for Way partners: list experiences, check availability, run
    checkout, and manage bookings.
  version: '1.0'
servers:
  - url: https://api.letsway.com
    description: Production.
  - url: https://api.staging.letsway.com
    description: Staging.
security: []
tags:
  - name: Listings
    description: 'Retrieve the listings a brand offers: experiences, events, and resources.'
  - name: Availability
    description: Dates, sessions, and price tiers for scheduling a booking.
  - name: Carts & Checkout
    description: >-
      Payment intents and booking creation. The cart ID is a client-generated
      UUID; there is no create-cart endpoint.
  - name: Bookings
    description: Retrieve, cancel, and reschedule bookings.
  - name: Experiences
    description: Experience details, settings, custom questions, reviews, and hosts.
  - name: Brand Configuration
    description: Brand settings, taxonomy, terms, and promotion code validation.
  - name: Waitlists
    description: Waitlists for sold-out sessions and invitation handling.
  - name: Integrations
    description: Configured integrations, analytics, and room-charge validation.
  - name: Organizations
    description: Organization-level access across brands.
paths:
  /v1/carts/{cartId}:
    get:
      tags:
        - Carts & Checkout
      summary: Get booking details by cart
      description: >-
        Returns a cart's purchaser and booking context, typically read after
        payment confirmation.
      operationId: BookingPublicController_getBookingDetailsByCart
      parameters:
        - $ref: '#/components/parameters/cartIdPath'
      responses:
        '200':
          description: Booking details.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BookingDetailsForCartDto'
              example:
                data:
                  cartId: 1ccd47b4-8784-43a0-86a5-fc733265f3c4
                  purchaser:
                    firstName: Alice
                    lastName: Rivera
                    emailAddress: alice@example.com
                    phoneNumber: '+15550100'
                    customQuestionAnswers: []
                  paymentProvider: self
                  paymentReferenceCode: null
                  paymentMethod: cash
                  meta: null
                  cartItems:
                    - experience:
                        id: c99f70ee-1c0e-4534-a31a-96d5d966cc4b
                        title: Sunset Sailing Tour
                        hidePrice: false
                        location:
                          id: 0e4e5db1-de94-41f8-9713-5074f9f0645a
                          name: Austin, TX, USA
                          city: Austin
                          state: TX
                          country: United States
                          longitude: -97.7430608
                          latitude: 30.267153
                          timezoneId: America/Chicago
                          additionalInfo: ''
                          createdAt: '2025-09-10T18:14:52.118Z'
                          updatedAt: '2025-09-10T18:14:52.118Z'
                        coverPicture:
                          id: 0a4cd3a1-d099-4916-90ea-7e5012c06598
                          mimeType: image/jpeg
                          uri:
                            original: >-
                              https://images.letsway.com/staging/tr:w-original/https://storage.googleapis.com/kouto-api-media/2026/6/accbde4c0064e535c67fd874a3b95d235d72465ed862dca1.jpg
                      priceTiers:
                        - id: 6c59db13-2c63-43b9-b91b-6267544f5fdb
                          name: Participant
                          price: 100
                          amount: 100
                          participantsCount: 1
                      participants:
                        - id: 019f5ca1-5432-751e-8663-7c22693a6e7e
                          firstName: Alice
                          lastName: Rivera
                          emailAddress: null
                          phoneNumber: null
                          priceTierName: Participant
                          priceTierId: 6c59db13-2c63-43b9-b91b-6267544f5fdb
                          bookingHistoryId: 019f5ca1-4dc1-775d-a40d-867ede918c04
                          ticketNumber: '13610576'
                          cancelledAt: null
                          isCheckedIn: false
                          checkInHistories: []
                          customQuestionAnswers: []
                      amount: 100
                      taxes: []
                      subTotal: 100
                      discountAmount: 0
                      notes: null
                      currency: USD
                      mode: shared
                      startDateTime: 2026-07-14T10:00
                      sessionDurationMinutes: 60
                  cartStatus: confirmed
      security:
        - Brand-API-Key: []
        - Organization-API-Key: []
components:
  parameters:
    cartIdPath:
      name: cartId
      in: path
      schema:
        type: string
      required: true
      description: Only bookings created from this cart.
      example: c4a1b2c3-d4e5-4f6a-8b9c-0d1e2f3a4b5c
  schemas:
    BookingDetailsForCartDto:
      type: object
      properties:
        cartId:
          type: string
          description: The unique identifier of the cart.
          example: cart-123
        purchaser:
          description: Purchaser details.
          allOf:
            - $ref: '#/components/schemas/PurchaserWithAnswersDto'
        paymentProvider:
          type: string
          description: Payment provider used for the transaction.
          enum:
            - kicc
            - stripe_destination_charge
            - stripe_separate_charge_transfer
            - self
          example: stripe_destination_charge
        paymentReferenceCode:
          type: object
          description: Payment reference code.
          example: PAY-789
          nullable: true
        paymentMethod:
          type: string
          description: Payment method used.
          enum:
            - credit-card
            - room-charge
            - member-number
            - loyalty
            - kicc
            - cash
            - pay-later
            - pay-upon-arrival
          example: credit-card
        meta:
          description: Additional metadata about the payment.
          nullable: true
          allOf:
            - $ref: '#/components/schemas/MetaDto'
        couponCode:
          type: string
          description: Applied coupon code.
          example: DISCOUNT10
          nullable: true
        cartItems:
          description: Cart items included in the booking.
          type: array
          items:
            $ref: '#/components/schemas/CartItemsDto'
        cartStatus:
          type: string
          description: Current status of the booking.
          enum:
            - confirmed
            - refunded
            - processing
            - failed
            - cancelled
          example: confirmed
      required:
        - cartId
        - purchaser
        - paymentProvider
        - paymentMethod
        - cartItems
        - cartStatus
    PurchaserWithAnswersDto:
      type: object
      properties:
        firstName:
          type: string
          description: First name of the purchaser.
          example: John
        lastName:
          type: string
          description: Last name of the purchaser.
          example: Doe
        emailAddress:
          type: string
          description: Email address of the purchaser.
          example: john.doe@example.com
        phoneNumber:
          type: string
          description: Phone number of the purchaser.
          example: '+1234567890'
          nullable: true
        customQuestionAnswers:
          description: Custom question answers.
          type: array
          items:
            $ref: '#/components/schemas/AnswerDto'
      required:
        - firstName
        - lastName
        - emailAddress
        - customQuestionAnswers
    MetaDto:
      type: object
      properties:
        paymentStatus:
          description: Payment status details.
          nullable: true
          allOf:
            - $ref: '#/components/schemas/PaymentStatusDto'
        paymentDetail:
          description: Payment details.
          nullable: true
          allOf:
            - $ref: '#/components/schemas/PaymentDetailDto'
        paymentMethodDetail:
          description: Payment method details.
          nullable: true
          allOf:
            - $ref: '#/components/schemas/PaymentMethodDetailDto'
    CartItemsDto:
      type: object
      properties:
        experience:
          description: Experience details associated with the cart item.
          allOf:
            - $ref: '#/components/schemas/CartExperienceDto'
        amount:
          type: number
          description: Total amount for this cart item.
          example: 250.75
        subTotal:
          type: number
          description: Subtotal of the cart item.
          example: 200.5
          nullable: true
        discountAmount:
          type: object
          description: Discount amount applied.
          example: 50.25
          nullable: true
        currency:
          type: string
          description: Currency used for the payment.
          example: USD
        startDateTime:
          type: string
          description: Start date and time of the experience in ISO format.
          example: '2024-03-15T14:30:00Z'
        sessionDurationMinutes:
          type: number
          description: Session duration in minutes.
          example: 90
          nullable: true
      required:
        - experience
        - amount
        - currency
        - startDateTime
    AnswerDto:
      type: object
      properties:
        answers:
          type: object
          description: Custom question answers.
          example:
            question-123:
              - answer-1
              - answer-2
      required:
        - answers
    PaymentStatusDto:
      type: object
      properties:
        code:
          type: string
          description: Payment status code.
          example: SUCCESS
        message:
          type: string
          description: Payment status message.
          example: Payment completed successfully
      required:
        - code
        - message
    PaymentDetailDto:
      type: object
      properties:
        lastName:
          type: string
          description: Last name on the payment method.
          example: Doe
          nullable: true
        methodNumber:
          type: string
          description: Payment method number.
          example: '**** **** **** 1234'
          nullable: true
        reservationId:
          type: string
          description: Reservation ID associated with payment.
          example: RES-456
          nullable: true
        confirmationId:
          type: string
          description: Confirmation ID of the payment.
          example: CONF-789
          nullable: true
    PaymentMethodDetailDto:
      type: object
      properties:
        fixedChargeId:
          type: string
          description: Fixed charge ID.
          example: CHG-123
          nullable: true
        billingChargeId:
          type: string
          description: Billing charge ID.
          example: BILL-456
          nullable: true
        transactionCode:
          type: object
          description: Transaction code details.
          example:
            code: T123
            description: Credit Card.
    CartExperienceDto:
      type: object
      properties:
        id:
          type: string
          description: The unique identifier of the experience.
          example: exp-123
        title:
          type: string
          description: Title of the experience.
          example: Luxury Yacht Tour
        hidePrice:
          type: boolean
          description: Indicates if the price should be hidden.
          example: false
      required:
        - id
        - title
        - hidePrice
  securitySchemes:
    Brand-API-Key:
      type: http
      scheme: bearer
      description: >-
        Your brand's secret API key, e.g. `Bearer
        way_sk_live_bhEqcn0i1fRoUEHBPjJkQA`. Older `Way-Brand-Id` +
        `Way-Secret-Key` credentials still work: see [Legacy
        authentication](/legacy-authentication).
    Organization-API-Key:
      type: http
      scheme: bearer
      description: >-
        Your organization's secret API key, e.g. `Bearer
        way_sk_live_ohEqcn0i1fRoUEHBPjJkQA`. Older `Way-Organization-Id` +
        `Way-Secret-Key` credentials still work: see [Legacy
        authentication](/legacy-authentication).

````