Create a new cart item Beta

Add MCP server to your AI tool

Allow AI tools and LLMs to interact with the API documentation portal through MCP.

MCP server URL

https://developer.pace.cloud/doc/cart/mcp

Standard setup for AI tools providing an mcp.json file

mcp.json 
{
  "Cart MCP server": {
    "url": "https://developer.pace.cloud/doc/cart/mcp"
  }
}
Close
POST /2025-3/cart-items
Oauth2 Oauth2

Adds a new item to the specified cart, allowing the user to configure and check out a product.

application/json

Body Required

  • cartId string(uuid) Required

    The unique identifier of the cart to add the item to.

  • productId string(uuid) Required

    The unique identifier of the product to be added to the cart.

Responses

  • 201 application/json

    The cart item has been successfully created.

    Hide response attribute Show response attribute object
    • data object Required

      The cart item that has been created.

      Hide data attributes Show data attributes object
      • authorization object Required

        The authorization details for the cart item.

        Hide authorization attributes Show authorization attributes object
        • amount string(decimal) Required

          The amount to be authorized. Either provided by the user or the server.

        • currency string Required

          The currency of the authorization.

      • cancelledAt string(date-time) | null Required

        The date and time when the cart item was cancelled.

      • cartId string(uuid) Required

        The unique identifier for the cart to which this item belongs.

      • checkout object Required

        The checkout details for the cart item.

        Hide checkout attributes Show checkout attributes object
        • currency string Required

          The currency of the checkout.

        • priceExcludingVAT string(decimal) Required

          The total price of the cart item, excluding VAT.

          Minimum value is 0.

        • priceIncludingVAT string(decimal) Required

          The total price of the cart item, including VAT.

          Minimum value is 0.

        • pricePerUnitExcludingVAT string(decimal) Required

          The price per unit of the cart item, Excluding VAT.

          Minimum value is 0.

        • pricePerUnitIncludingVAT string(decimal) Required

          The price per unit of the cart item, including VAT.

          Minimum value is 0.

        • quantity string(decimal) Required

          The consumed quantity of the cart item.

        • status string Required

          The status of the cart item regarding the checkout process.

          Values are PENDING, PROCESSING, COMPLETED, FAILED, or CANCELLED.

        • unit string Required

          The unit of measurement for the cart item quantity.

        • vatAmount string(decimal) Required

          The total amount of VAT applied to the cart item.

          Minimum value is 0.

        • vatRate string(decimal) Required

          The vat rate applied to the cart item.

          Minimum value is 0.

      • configurations array[object] Required

        The configurations applied to the cart item.

        One of:
        CartItemConfigurationInputTypeDTO object CartItemConfigurationSingleSelectTypeDTO object CartItemConfigurationMultiSelectTypeDTO object CartItemConfigurationLocationTypeDTO object
      • configuredAt string(date-time) | null Required

        The date and time when the cart item was configured.

      • createdAt string(date-time) Required

        The date and time when the cart item was created.

      • id string(uuid) Required

        The unique identifier for the cart item.

      • metadata object

        Optional metadata associated with the cart item. This may vary depending on the product and provider.

        Additional properties are allowed.

      • next object Required

        The next configuration that needs to be applied to the cart item.

        One of:
        CartItemNextConfigurationInputTypeDTO object CartItemNextConfigurationSingleSelectTypeDTO object CartItemNextConfigurationMultiSelectTypeDTO object CartItemNextConfigurationLocationTypeDTO object
      • product object Required

        The product details associated with the cart item.

        Hide product attributes Show product attributes object
        • id string(uuid) Required

          The unique identifier for the cart product.

        • label string Required

          A human-readable label for the cart product.

        • type string Required

          The type of the cart product.

      • status string Required

        The current status of the cart item.

        Values are CONFIGURING, CONFIGURED, or CANCELLED.

      • updatedAt string(date-time) Required

        The date and time when the cart item was last updated.
  • 401

    Client authentication failed.

  • 403

    Missing one or more required scopes.

  • 404

    The specified cart or product was not found.

  • 500

    An unexpected error occurred.

POST /2025-3/cart-items 
curl \
 --request POST 'https://api.pace.cloud/cart/2025-3/cart-items' \
 --header "Authorization: Bearer $ACCESS_TOKEN" \
 --header "Content-Type: application/json" \
 --data '{
  "cartId": "3682ea8c-4ca4-45d2-bc1e-e6e4dc597ffb",
  "productId": "439436d5-3079-47b5-8803-f781c61dbad8"
}'
Request examples 
{
  "cartId": "3682ea8c-4ca4-45d2-bc1e-e6e4dc597ffb",
  "productId": "439436d5-3079-47b5-8803-f781c61dbad8"
}
Response examples (201) 
{
  "data": {
    "authorization": {
      "amount": "120",
      "currency": "EUR"
    },
    "cancelledAt": "2025-03-15T12:00:00.000Z",
    "cartId": "71597ea2-e7e7-4eb5-b5c5-01eec9c1d81b",
    "checkout": {
      "currency": "EUR",
      "priceExcludingVAT": "61.26",
      "priceIncludingVAT": "72.90",
      "pricePerUnitExcludingVAT": "1.419",
      "pricePerUnitIncludingVAT": "1.689",
      "quantity": "43.17",
      "status": "PENDING",
      "unit": "LITER",
      "vatAmount": "8.23",
      "vatRate": "0.19"
    },
    "configurations": [
      {
        "label": "Pump Number",
        "name": "PUMP_NUMBER",
        "type": "INPUT",
        "value": "100"
      }
    ],
    "configuredAt": "2025-03-15T12:00:00.000Z",
    "createdAt": "2025-03-15T12:00:00.000Z",
    "id": "c7b3d2af-4046-4711-8fbf-36ce1b5f31d3",
    "metadata": {},
    "next": {
      "label": "Pump Number",
      "name": "PUMP_NUMBER",
      "pattern": "string",
      "type": "INPUT"
    },
    "product": {
      "id": "88dd01e3-c300-44af-83e6-86b362c8fa39",
      "label": "PACE Connected Fueling",
      "type": "FUELING"
    },
    "status": "CONFIGURING",
    "updatedAt": "2025-03-16T12:00:00.000Z"
  }
}