What parameters does PUT /V1/guest-carts/:cartId/collect-totals accept?

This endpoint accepts 5 parameters: cartId (string) required; paymentMethod (Magento\Quote\Api\Data\PaymentInterface) required; shippingCarrierCode (string); shippingMethodCode (string); additionalData (Magento\Quote\Api\Data\TotalsAdditionalDataInterface).

What does PUT /V1/guest-carts/:cartId/collect-totals return?

The endpoint returns Magento\Quote\Api\Data\TotalsInterface.

Does PUT /V1/guest-carts/:cartId/collect-totals require authentication?

This endpoint can be called anonymously — no Authorization header required.

MageSmith

PUTQuote · Magento 2.4.9 Anonymous

PUT /V1/guest-carts/:cartId/collect-totals

Q: What does the PUT /V1/guest-carts/:cartId/collect-totals endpoint do in Magento 2?

PUT /V1/guest-carts/:cartId/collect-totals is a Magento 2 REST endpoint in the Quote module. Set shipping/billing methods and additional data for cart and collect totals for guest. Callable anonymously — no Authorization header required.

PUT /V1/guest-carts/:cartId/collect-totals is a Magento 2 REST endpoint in the Quote module. Set shipping/billing methods and additional data for cart and collect totals for guest. Callable anonymously — no Authorization header required.

Last verified: 2026-05-23 against Magento 2.4.9.

Returns

Magento\Quote\Api\Data\TotalsInterface

Quote totals data.

Service contract

Magento\Quote\Api\GuestCartTotalManagementInterface::collectTotals

Authorization

Anonymous — no Authorization header required.

Path parameters

cartId string Required

The cart ID.

Body parameters

paymentMethod Magento\Quote\Api\Data\PaymentInterface Required

Payment method data.

shippingCarrierCode string default: null

The carrier code.

shippingMethodCode string default: null

The shipping method code.

additionalData Magento\Quote\Api\Data\TotalsAdditionalDataInterface default: null

Additional data to collect totals.

Example request

Auto-generated from the service contract — paste-ready against your store's /rest/default base. Replace the host, store code, ACL token, and any required values before running.

Headers

application/json

Content-Type

application/json

Path

/V1/guest-carts/{cartId}/collect-totals

Body

{
  "additionalData": {
    "custom_attributes": [
      {
        "attribute_code": "",
        "value": ""
      }
    ],
    "extension_attributes": {}
  },
  "paymentMethod": {
    "additional_data": [
      {}
    ],
    "extension_attributes": {},
    "method": "",
    "po_number": ""
  },
  "shippingCarrierCode": "",
  "shippingMethodCode": ""
}