Get a cart item

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
GET /2026-3/carts/{cartId}/items/{cartItemId}
Oauth2 Oauth2 Oauth2

Retrieves a specific item in a specified cart, including its details and configurations.

Path parameters

  • cartId string(uuid) Required

    The unique identifier of the cart the item belongs to.

  • cartItemId string(uuid) Required

    The unique identifier of the cart item to retrieve.

Responses

  • 200 application/json

    The cart item for the given identifier.

    Hide response attribute Show response attribute object
    • data object Required

      The cart item with for the specified cart.

      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 processing 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
        • cancelledAt string(date-time) | null Required

          The date and time when the checkout process was cancelled, if applicable.

        • completedAt string(date-time) | null Required

          The date and time when the checkout process completed, if applicable.

        • failedAt string(date-time) | null Required

          The date and time when the checkout process failed, if applicable.

        • failureCode string | null Required

          The failure code of the cart item checkout process, if any. Free-form: new codes are introduced without a version change, so treat an unrecognized value as an unspecified failure.

        • startedAt string(date-time) Required

          The date and time when the checkout process started.

        • status string Required

          The status of the cart item checkout process.

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

      • completedAt string(date-time) | null Required

        The date and time when the cart item has completed processing.

      • configurations object Required

        The configurations applied to the cart item.

        One of:
        INPUT object LOCATION object MULTI_SELECT object PERIODS object SINGLE_SELECT 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.

      • failedAt string(date-time) | null Required

        The date and time when the cart item failed processing.

      • 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:
        INPUT object SINGLE_SELECT object MULTI_SELECT object LOCATION object USER_ACTION 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.

          Any of:
          string-1 string string-2 string

          Values are FUELING, WASHING, or CHARGING.

      • status string Required

        The current status of the cart item.

        Values are CONFIGURING, CONFIGURED, PROCESSING, COMPLETED, CANCELLED, or FAILED.

      • summary object Required

        The summary details for the cart item.

        Hide summary attributes Show summary 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.

        • unit string Required

          The unit of measurement for the cart item quantity.

          Any of:
          string-1 string string-2 string

          Values are ITEM, LITER, KILOGRAM, or KWH.

        • 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.

      • transactionId string(uuid) Required

        The unique identifier of the transaction at the product service that fulfills this cart item, which can be used to fetch details directly from that service.

      • updatedAt string(date-time) Required

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

    The request parameters are missing or invalid.

  • 401

    Client authentication failed.

  • 403

    Missing one or more required scopes.

  • 404

    The specified cart item was not found in the specified cart.

  • 500

    An unexpected error occurred.

GET /2026-3/carts/{cartId}/items/{cartItemId} 
curl \
 --request GET 'https://api.pace.cloud/cart/2026-3/carts/3682ea8c-4ca4-45d2-bc1e-e6e4dc597ffb/items/8576a377-5a1b-4d04-8051-36cb996e9f6e' \
 --header "Authorization: Bearer $ACCESS_TOKEN"
Response examples (200) 
{
  "data": {
    "authorization": {
      "amount": "120",
      "currency": "EUR"
    },
    "cancelledAt": "2025-03-15T12:00:00.000Z",
    "cartId": "71597ea2-e7e7-4eb5-b5c5-01eec9c1d81b",
    "checkout": {
      "cancelledAt": "2024-01-01T12:03:00Z",
      "completedAt": "2024-01-01T12:05:00Z",
      "failedAt": "2024-01-01T12:04:00Z",
      "failureCode": "UNKNOWN",
      "startedAt": "2024-01-01T12:00:00Z",
      "status": "COMPLETED"
    },
    "completedAt": "2025-03-15T12:00:00.000Z",
    "configurations": {
      "description": "string",
      "label": "Pump Number",
      "name": "PUMP_NUMBER",
      "type": "INPUT",
      "value": "100"
    },
    "configuredAt": "2025-03-15T12:00:00.000Z",
    "createdAt": "2025-03-15T12:00:00.000Z",
    "failedAt": "2025-03-15T12:00:00.000Z",
    "id": "c7b3d2af-4046-4711-8fbf-36ce1b5f31d3",
    "metadata": {},
    "next": {
      "description": "string",
      "label": "Pump Number",
      "name": "PUMP_NUMBER",
      "pattern": "string",
      "type": "INPUT"
    },
    "product": {
      "id": "88dd01e3-c300-44af-83e6-86b362c8fa39",
      "label": "Fueling",
      "type": "FUELING"
    },
    "status": "CONFIGURING",
    "summary": {
      "currency": "EUR",
      "priceExcludingVAT": "61.26",
      "priceIncludingVAT": "72.90",
      "pricePerUnitExcludingVAT": "1.419",
      "pricePerUnitIncludingVAT": "1.689",
      "quantity": "43.17",
      "unit": "LITER",
      "vatAmount": "8.23",
      "vatRate": "0.19"
    },
    "transactionId": "9c2f1e7a-3b4d-4f8a-9c1e-2d6b8a0f5e3c",
    "updatedAt": "2025-03-16T12:00:00.000Z"
  }
}