Get a cart. 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
GET /2026-4/carts/{cartId}

Retrieves a specific cart.

Path parameters

  • cartId string(uuid) Required

    The unique identifier of the cart to retrieve.

Responses

  • 200 application/json

    The cart with the specified ID.

    Hide response attribute Show response attribute object
    • data object Required

      The cart with the specified ID.

      Hide data attributes Show data attributes object
      • checkout object Required

        A minimal summary of the cart's latest checkout attempt, or null if no checkout has been created yet.

        Hide checkout attributes Show checkout attributes object
        • cancelledAt string(date-time) | null Required

          The timestamp when the cart checkout was cancelled.

        • completedAt string(date-time) | null Required

          The timestamp when the cart checkout was completed.

        • failedAt string(date-time) | null Required

          The timestamp when the cart checkout failed.

        • failureCode string | null Required

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

        • id string(uuid) Required

          The unique identifier of the checkout.

        • startedAt string(date-time) Required

          The timestamp when the cart checkout was started.

        • status string Required

          The status of the cart checkout.

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

      • clientId string Required

        The unique identifier of the client through which this cart was created.

      • createdAt string(date-time) Required

        The timestamp when the cart was created.

      • expiresAt string(date-time) | null Required

        The timestamp at which the cart lapses if nothing interacts with it before then. Every interaction with the cart pushes it further out, so read the current value rather than assuming a fixed window. It is null once the checkout has completed.

      • id string(uuid) Required

        The unique identifier for the cart.

      • paymentMethodId string(uuid) | null Required

        The unique identifier of the payment method selected for this cart, or null while none is selected. Adding, configuring or removing an item clears the selection.

      • poiId string(uuid) Required

        The unique identifier of the POI associated with this cart.

      • status string Required

        The current status of the cart.

        Values are OPEN, PROCESSING, COMPLETED, CANCELLED, FAILED, EXHAUSTED, or EXPIRED.

      • summary object Required

        A post-settlement aggregate of the cart's totals, or null until every non-cancelled item has settled.

        Hide summary attributes Show summary attributes object
        • currency string Required

          The currency of the cart total.

        • priceExcludingVAT string(decimal) Required

          The total price of the cart, excluding VAT.

          Minimum value is 0.

        • priceIncludingVAT string(decimal) Required

          The total price of the cart, including VAT.

          Minimum value is 0.

        • vatAmount string(decimal) Required

          The total amount of VAT applied to the cart.

          Minimum value is 0.

      • updatedAt string(date-time) Required

        The timestamp when the cart was last updated.

      • userId string(uuid) Required

        The unique identifier of the user who owns this cart.

  • 400

    The request parameters are missing or invalid.

  • 401

    Client authentication failed.

  • 403

    Missing one or more required scopes.

  • 404

    The specified cart was not found.

  • 500

    An unexpected error occurred.

GET /2026-4/carts/{cartId}
curl \
 --request GET 'https://api.pace.cloud/cart/2026-4/carts/16b99f34-6ad0-4f46-9e46-c6ffe6e4f135' \
 --header "Authorization: Bearer $ACCESS_TOKEN"
Response examples (200)
{
  "data": {
    "checkout": {
      "cancelledAt": "2023-05-15T14:30:00.000Z",
      "completedAt": "2023-05-15T15:00:00.000Z",
      "failedAt": "2023-05-15T14:30:00.000Z",
      "failureCode": "INSUFFICIENT_FUNDS",
      "id": "f1e2d3c4-b5a6-4789-9c0d-1e2f3a4b5c6d",
      "startedAt": "2023-05-15T14:00:00.000Z",
      "status": "PROCESSING"
    },
    "clientId": "pace-drive-app",
    "createdAt": "2023-05-15T14:00:00.000Z",
    "expiresAt": "2023-05-16T14:30:00.000Z",
    "id": "ae1b58ef-ba5c-4240-b130-51fcf067d40d",
    "paymentMethodId": "ecbec75f-7ca4-4017-a485-6a4836de5d25",
    "poiId": "96a939ea-28d4-4228-b45c-192904ba91d7",
    "status": "OPEN",
    "summary": {
      "currency": "EUR",
      "priceExcludingVAT": "61.26",
      "priceIncludingVAT": "72.90",
      "vatAmount": "11.64"
    },
    "updatedAt": "2023-05-15T14:15:00.000Z",
    "userId": "e9166a60-1f92-4a5d-a192-c2f6b662e9d9"
  }
}