# Add Activity to Cart

As part of successfully updating or adding an activity to the cart, the response will contain the updated cart contents. See the details in [zapiGetCartContents](/zapi/zapi-calls/interacting-with-a-cart/get-cart-contents.md) for the details for this particular callback.

For overview of activity types, please see [Activity Type IDs](/zapi/appendix/activity-type-ids.md) in the Appendix.&#x20;

## zapiAddActivityToCart

<mark style="color:green;">`POST`</mark> `https://{yourdomain}.zaui.net/zapi/`

Adds a single activity to the cart order

#### Request Body

| Name                                                   | Type    | Description                                                                                                                                       |
| ------------------------------------------------------ | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------- |
| activityId<mark style="color:red;">\*</mark>           | integer | ID of the activity.                                                                                                                               |
| activityDate<mark style="color:red;">\*</mark>         | integer | The travel start date.  Format: YYYY:MM:DD.                                                                                                       |
| activityTime<mark style="color:red;">\*</mark>         | integer | Activity departure time. Required for activity type Ids 502 and 503 only. Format: HH:MM:SS.                                                       |
| passengers<mark style="color:red;">\*</mark>           | integer | Number of passengers to add to the cart                                                                                                           |
| CategoryId<mark style="color:red;">\*</mark>           | integer | ID for a category of equipment. Required for equipment-based rental activity types.                                                               |
| equipmentCategoryName                                  | string  | Name of a category of equipment                                                                                                                   |
| equipmentId                                            | integer | ID for a specific piece of equipment.                                                                                                             |
| activityTimeOptionId<mark style="color:red;">\*</mark> | integer | Activity Time option ID. Retrieved by running the [zapiGetActivityDetailsByActivityId ](/zapi/zapi-calls/activity-calls/activity-details.md)call. |
| methodName<mark style="color:red;">\*</mark>           | string  | The method being called.                                                                                                                          |
| zapiUserId<mark style="color:red;">\*</mark>           | integer | Generated by the supplier system when a new contact is created.                                                                                   |
| zapiAccountId<mark style="color:red;">\*</mark>        | integer | Generated by the supplier system.                                                                                                                 |
| zapiToken<mark style="color:red;">\*</mark>            | integer | Token that must be used for a reseller to communicate with the supplier system.                                                                   |
| cartId<mark style="color:red;">\*</mark>               | integer | ID of the current cart session to add the activity to.                                                                                            |
| activityEndDate<mark style="color:red;">\*</mark>      | integer | The travel end date.  Required for ALL rental activity types only. Format: YYYY:MM:DD.                                                            |
| rentalStartTime<mark style="color:red;">\*</mark>      | integer | The start time of the rental activity.  Required for ALL rental activity types only. Format: HH:MM:SS.                                            |
| rentalEndTime<mark style="color:red;">\*</mark>        | integer | The end time of the rental activity.  Required for ALL rental activity types only. Format: HH:MM:SS.                                              |
| dropOffLocationId<mark style="color:red;">\*</mark>    | integer | ID of the drop off location. Required for activity type Ids 504 only.                                                                             |
| pickupLocationId<mark style="color:red;">\*</mark>     | integer | ID of the pick up location. Required for activity type Ids 504 only.                                                                              |
| pricingOptions                                         | string  | Additional options available for an activity. If null, do not pass.                                                                               |

{% tabs %}
{% tab title="200 " %}

```markup
<?xml version="1.0" encoding="utf-8"?>
<response>
    <zapiVersion>2.1</zapiVersion>
    <error>0</error>
    <message>OK</message>
    <methodResponse>
        <methodName>zapiAddActivityToCart</methodName>
        <cart>
            <cartId>08578bc790686b98093137ce1984e514</cartId>
            <customers/>
            <activities>
                <activity>
                    <cartItemId>47280</cartItemId>
                    <packageId>0</packageId>
                    <packageName>
                        <![CDATA[]]>
                    </packageName>
                    <activityId>80</activityId>
                    <activityType>500</activityType>
                    <activityName>
                        <![CDATA[Canyon Icewalk ]]>
                    </activityName>
                    <supplierConfirmationNumber/>
                    <activityDate>2022-05-25</activityDate>
                    <activityTime>13:00:00</activityTime>
                    <formattedActivityDateTime>Wed, May 25 2022 1:00 PM</formattedActivityDateTime>
                    <inventoryRemainsAvailable>true</inventoryRemainsAvailable>
                    <pickupLocationId>0</pickupLocationId>
                    <pickupLocationName>
                        <![CDATA[]]>
                    </pickupLocationName>
                    <pickupLocationAddress>
                        <![CDATA[]]>
                    </pickupLocationAddress>
                    <pickupLocationTimeString>
                        <![CDATA[ ]]>
                    </pickupLocationTimeString>
                    <pickupDestinationId>0</pickupDestinationId>
                    <pickupDestinationName>
                        <![CDATA[]]>
                    </pickupDestinationName>
                    <dropOffLocationId>0</dropOffLocationId>
                    <dropOffLocationName>
                        <![CDATA[]]>
                    </dropOffLocationName>
                    <dropOffAddress>
                        <![CDATA[]]>
                    </dropOffAddress>
                    <dropOffLocationTimeString>
                        <![CDATA[ ]]>
                    </dropOffLocationTimeString>
                    <dropoffDestinationId>0</dropoffDestinationId>
                    <dropoffDestinationName>
                        <![CDATA[]]>
                    </dropoffDestinationName>
                    <notes>
                        <![CDATA[]]>
                    </notes>
                    <bookingHistoryNote>
                        <![CDATA[ Adding Canyon Icewalk  at 1:00 PM for Wednesday, May 25 2022<br>Commissioned To: Zaui Development - Nadine Dauberman]]>
                    </bookingHistoryNote>
                    <isFreeSell>false</isFreeSell>
                    <ticketExpiry/>
                    <ticketPrinterText>
                        <![CDATA[Please keep this ticket for your records.]]>
                    </ticketPrinterText>
                    <operatedByCompanyId>1</operatedByCompanyId>
                    <operatedByCompanyName>
                        <![CDATA[Supplier Test System]]>
                    </operatedByCompanyName>
                    <category>
                        <categoryId>8</categoryId>
                        <categoryName>
                            <![CDATA[Canyon Walks]]>
                        </categoryName>
                    </category>
                    <seniors>0</seniors>
                    <seniorsLabel>
                        <![CDATA[Seniors]]>
                    </seniorsLabel>
                    <adults>0</adults>
                    <adultsLabel>
                        <![CDATA[Adults]]>
                    </adultsLabel>
                    <students>0</students>
                    <studentsLabel>
                        <![CDATA[Students]]>
                    </studentsLabel>
                    <children>0</children>
                    <childrenLabel>
                        <![CDATA[Children]]>
                    </childrenLabel>
                    <infants>0</infants>
                    <infantsLabel>
                        <![CDATA[Infants]]>
                    </infantsLabel>
                    <passengersAsString>
                        <![CDATA[]]>
                    </passengersAsString>
                    <totalCost>$0.00</totalCost>
                    <pricingOptions/>
                    <onStandby>false</onStandby>
                    <onWaitList>false</onWaitList>
                    <waitListId>0</waitListId>
                    <tickets>
                        <ticket>
                            <companyName>
                                <![CDATA[Supplier Test System]]>
                            </companyName>
                            <companyPhone>
                                <![CDATA[6045669284]]>
                            </companyPhone>
                            <companyWebsite>
                                <![CDATA[www.zaui.com]]>
                            </companyWebsite>
                            <companyCityAndProvince>
                                <![CDATA[Vancouver, BC]]>
                            </companyCityAndProvince>
                            <bookingNumber>0</bookingNumber>
                            <customerName>
                                <![CDATA[ ]]>
                            </customerName>
                            <activityName>
                                <![CDATA[Canyon Icewalk ]]>
                            </activityName>
                            <activityDate>
                                <![CDATA[2022-05-25]]>
                            </activityDate>
                            <activityTime>
                                <![CDATA[13:00:00]]>
                            </activityTime>
                            <pickupLocationTime>
                                <![CDATA[]]>
                            </pickupLocationTime>
                            <dropoffLocationTime>
                                <![CDATA[]]>
                            </dropoffLocationTime>
                            <printerText>
                                <![CDATA[Please keep this ticket for your records.]]>
                            </printerText>
                            <barcodeType>
                                <![CDATA[qrcode]]>
                            </barcodeType>
                            <barcodeString>
                                <![CDATA[%^f0a00e311056a278b559f36c245169c913974cba^0_A80|2022-05-25|13:00:00|0^%]]>
                            </barcodeString>
                            <barcodeLabel>
                                <![CDATA[]]>
                            </barcodeLabel>
                            <paxTypeLabel>
                                <![CDATA[]]>
                            </paxTypeLabel>
                            <customCategoryText>
                                <![CDATA[]]>
                            </customCategoryText>
                        </ticket>
                    </tickets>
                    <equipment/>
                    <checkedInStatus>Not Checked In</checkedInStatus>
                </activity>
            </activities>
            <products/>
            <remainingBalance>
                <balance>$0.00</balance>
            </remainingBalance>
            <cartTotals>
                <bookingNumber>0</bookingNumber>
                <modifyBookingNumber>0</modifyBookingNumber>
                <bookingSourcedOnline/>
                <activityTotal>$0.00</activityTotal>
                <activityTax>$0.00</activityTax>
                <productTotal>$0.00</productTotal>
                <productTax>$0.00</productTax>
                <packageTotal>$0.00</packageTotal>
                <activitySurplusFees>$0.00</activitySurplusFees>
                <guestFee>$0.00</guestFee>
                <surchargeTotal>$0.00</surchargeTotal>
                <perPersonTax>$0.00</perPersonTax>
                <total>$0.00</total>
                <tax>$0.00</tax>
                <taxUnrounded>$0.00</taxUnrounded>
                <totalIncludingTax>$0.00</totalIncludingTax>
                <totalNetAmount>$0.00</totalNetAmount>
                <zauiMerchantFee>$0.30</zauiMerchantFee>
                <packageTotal_formatted>$0.00</packageTotal_formatted>
                <activityTotal_formatted>$0.00</activityTotal_formatted>
                <productTotal_formatted>$0.00</productTotal_formatted>
                <subtotal_formatted>$0.00</subtotal_formatted>
                <tax_formatted>$0.00</tax_formatted>
                <totalIncludingTax_formatted>$0.00</totalIncludingTax_formatted>
                <totalNetAmount_formatted>$0.00</totalNetAmount_formatted>
                <taxes>
                    <tax>
                        <taxDisplayName>GST</taxDisplayName>
                        <taxAmount>0</taxAmount>
                        <taxAmount_formatted>$0.00</taxAmount_formatted>
                    </tax>
                </taxes>
            </cartTotals>
        </cart>
        <currencies/>
        <methodErrorCode>0</methodErrorCode>
        <methodErrorMessage>
            <![CDATA[Added ]]>
        </methodErrorMessage>
    </methodResponse>
</response
```

{% endtab %}
{% endtabs %}

{% tabs %}
{% tab title="Request" %}

```markup
<request>
   <zapiToken></zapiToken>
   <zapiAccountId></zapiAccountId>
   <zapiUserId></zapiUserId>
   <zapiMethod>
    <methodName>zapiAddActivityToCart</methodName>
    <cartId></cartId>
    <activityId></activityId>
    <activityDate></activityDate>
    <activityEndDate></activityEndDate>
    <activityTime></activityTime>
    <activityTimeOptionId></activityTimeOptionId>
    <rentalStartTime></rentalStartTime>
    <rentalEndTime></rentalEndTime>
    <pricingOptions></pricingOptions>
    <pickupLocationId></pickupLocationId>
    <pickupAddress/>
    <dropOffLocationId></dropOffLocationId>
    <dropoffAddress/>
    <passengers>
        <seniors></seniors>
        <adults></adults>
        <students></students>
        <children></children>
        <infants></infants>
    </passengers>
    <equipment>
      <equipmentCategory>
        <CategoryId></CategoryId>
        <equipmentCategoryName></equipmentCategoryName>
        <quantity></quantity>
      </equipmentCategory>
      <selectedEquipment>
        <equipmentId></equipmentId>
      </selectedEquipment>
    </equipment>
    <checkOnlineThresholds></checkOnlineThresholds>
  </zapiMethod>
</request>
```

{% endtab %}

{% tab title="Response" %}

```xml
<?xml version="1.0" encoding="utf-8"?>
<response>
    <zapiVersion>2.1</zapiVersion>
    <error>0</error>
    <message>OK</message>
    <methodResponse>
        <methodName>zapiAddActivityToCart</methodName>
        <cart>
            <cartId></cartId>
            <customers/>
            <activities>
                <activity>
                    <cartItemId></cartItemId>
                    <packageId></packageId>
                    <packageName></packageName>
                    <activityId></activityId>
                    <activityType></activityType>
                    <activityName></activityName>
                    <supplierConfirmationNumber/>
                    <activityDate></activityDate>
                    <activityTime></activityTime>
                    <formattedActivityDateTime></formattedActivityDateTime>
                    <inventoryRemainsAvailable></inventoryRemainsAvailable>
                    <pickupLocationId>0</pickupLocationId>
                    <pickupLocationName></pickupLocationName>
                    <pickupLocationAddress></pickupLocationAddress>
                    <pickupLocationTimeString></pickupLocationTimeString>
                    <pickupDestinationId></pickupDestinationId>
                    <pickupDestinationName></pickupDestinationName>
                    <dropOffLocationId></dropOffLocationId>
                    <dropOffLocationName></dropOffLocationName>
                    <dropOffAddress></dropOffAddress>
                    <dropOffLocationTimeString></dropOffLocationTimeString>
                    <dropoffDestinationId></dropoffDestinationId>
                    <dropoffDestinationName></dropoffDestinationName>
                    <notes></notes>
                    <bookingHistoryNote></bookingHistoryNote>
                    <isFreeSell></isFreeSell>
                    <ticketExpiry/>
                    <ticketPrinterText></ticketPrinterText>
                    <operatedByCompanyId></operatedByCompanyId>
                    <operatedByCompanyName></operatedByCompanyName>
                    <category>
                        <categoryId></categoryId>
                        <categoryName></categoryName>
                    </category>
                    <seniors></seniors>
                    <seniorsLabel></seniorsLabel>
                    <adults></adults>
                    <adultsLabel></adultsLabel>
                    <students></students>
                    <studentsLabel></studentsLabel>
                    <children></children>
                    <childrenLabel></childrenLabel>
                    <infants></infants>
                    <infantsLabel></infantsLabel>
                    <passengersAsString></passengersAsString>
                    <totalCost></totalCost>
                    <pricingOptions/>
                    <onStandby></onStandby>
                    <onWaitList></onWaitList>
                    <waitListId></waitListId>
                    <tickets>
                        <ticket>
                            <companyName></companyName>
                            <companyPhone></companyPhone>
                            <companyWebsite></companyWebsite>
                            <companyCityAndProvince></companyCityAndProvince>
                            <bookingNumber>0</bookingNumber>
                            <customerName></customerName>
                            <activityName></activityName>
                            <activityDate></activityDate>
                            <activityTime></activityTime>
                            <pickupLocationTime></pickupLocationTime>
                            <dropoffLocationTime></dropoffLocationTime>
                            <printerText></printerText>
                            <barcodeType></barcodeType>
                            <barcodeString></barcodeString>
                            <barcodeLabel></barcodeLabel>
                            <paxTypeLabel></paxTypeLabel>
                            <customCategoryText></customCategoryText>
                        </ticket>
                    </tickets>
                    <equipment/>
                    <checkedInStatus></checkedInStatus>
                </activity>
            </activities>
            <products/>
            <remainingBalance>
                <balance></balance>
            </remainingBalance>
            <cartTotals>
                <bookingNumber></bookingNumber>
                <modifyBookingNumber></modifyBookingNumber>
                <bookingSourcedOnline/>
                <activityTotal></activityTotal>
                <activityTax></activityTax>
                <productTotal></productTotal>
                <productTax></productTax>
                <packageTotal></packageTotal>
                <activitySurplusFees></activitySurplusFees>
                <guestFee></guestFee>
                <surchargeTotal></surchargeTotal>
                <perPersonTax></perPersonTax>
                <total></total>
                <tax></tax>
                <taxUnrounded></taxUnrounded>
                <totalIncludingTax></totalIncludingTax>
                <totalNetAmount></totalNetAmount>
                <zauiMerchantFee></zauiMerchantFee>
                <packageTotal_formatted></packageTotal_formatted>
                <activityTotal_formatted></activityTotal_formatted>
                <productTotal_formatted></productTotal_formatted>
                <subtotal_formatted></subtotal_formatted>
                <tax_formatted></tax_formatted>
                <totalIncludingTax_formatted></totalIncludingTax_formatted>
                <totalNetAmount_formatted></totalNetAmount_formatted>
                <taxes>
                    <tax>
                        <taxDisplayName></taxDisplayName>
                        <taxAmount></taxAmount>
                        <taxAmount_formatted></taxAmount_formatted>
                    </tax>
                </taxes>
            </cartTotals>
        </cart>
        <currencies/>
        <methodErrorCode></methodErrorCode>
        <methodErrorMessage></methodErrorMessage>
    </methodResponse>
</response>
```

{% endtab %}
{% endtabs %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.zaui.com/zapi/zapi-calls/interacting-with-a-cart/add-activity.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
