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

# Add Items to Cart (V2)

> Add product items to the user's shopping cart.



## OpenAPI

````yaml /openapi/freelance-internal-api.mintlify.json post /api/peterpans/cart/items/v2
openapi: 3.0.3
info:
  title: Freelance Travel App API Documentation
  description: >-
    API for the Freelance Travel App - managing users, products, cart, quotes,
    bookings, and agent integrations.
  version: 1.0.0
servers:
  - url: https://confirmation.freelancetravel.com
security:
  - default: []
tags:
  - name: Admin
    description: ''
  - name: Agent Integration
    description: |-

      APIs for managing travel agent integrations and upgrades
  - name: App Metadata
    description: ''
  - name: Authentication
    description: |-

      APIs for user authentication and account management
  - name: Caching
    description: ''
  - name: Cart & Quotes
    description: |-

      APIs for managing shopping cart items, quotes, and bookings
  - name: Discounts
    description: ''
  - name: Endpoints
    description: ''
  - name: Favourites
    description: ''
  - name: Products
    description: |-

      APIs for managing products and home feed
  - name: Redeemers
    description: ''
  - name: Shared Payments
    description: ''
  - name: System
    description: ''
paths:
  /api/peterpans/cart/items/v2:
    post:
      tags:
        - Cart & Quotes
      summary: Add Items to Cart (V2)
      description: Add product items to the user's shopping cart.
      operationId: addItemsToCartV2
      parameters:
        - in: query
          name: dry
          description: Dry run mode (1 = preview only).
          example: 0
          required: false
          schema:
            type: integer
            description: Dry run mode (1 = preview only).
            example: 0
        - in: query
          name: sessionId
          description: Guest session ID.
          example: sess_abc123
          required: false
          schema:
            type: string
            description: Guest session ID.
            example: sess_abc123
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                tdmsProductId:
                  type: string
                  description: The TDMS product ID.
                  example: PROD123
                startDate:
                  type: string
                  description: Start date (d-M-Y format).
                  example: 15-Jan-2024
                days:
                  type: integer
                  description: Number of days.
                  example: 3
                selectedAvailableIndices:
                  type: array
                  description: Selected availability indices.
                  example:
                    - 0
                    - 1
                  items:
                    type: string
                productPricesDetails:
                  type: array
                  description: Price details with quantities.
                  example:
                    - productPricesDetailsId: '123'
                      quantity: 2
                  items:
                    type: string
              required:
                - tdmsProductId
                - startDate
                - days
                - selectedAvailableIndices
                - productPricesDetails
      responses:
        '200':
          description: ''
          content:
            text/plain:
              schema:
                type: string
                example: >-
                  {"status": "success", "message": "Items added to cart",
                  "data": {...}}
components:
  securitySchemes:
    default:
      type: http
      scheme: bearer
      description: >-
        You can retrieve your token by visiting your dashboard and clicking
        <b>Generate API token</b>.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.