Create a new cart.

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 /2026-2/carts
Oauth2 Oauth2

Creates a new cart for a user and client.

application/json

Body Required

  • clientId string

    The client for which the cart should be created.

  • poiId string(uuid) Required

    The poi for which the cart should be created.

  • userId string(uuid)

    The user for which the cart should be created.

Responses

  • 201 application/json

    Successfully created a new cart

    Hide response attribute Show response attribute object
    • data object Required

      The cart that has been created.

      Hide data attributes Show data attributes object
      • checkout object Required

        The checkout associated with this cart.

        Hide checkout attributes Show checkout attributes object
        • actions object Required

          The actions that are required to complete the checkout process.

          One of:
          INPUT object MULTI_SELECT object ONE_OF object SINGLE_SELECT object
        • actionsUrl string(uri) | null Required

          The URL which the client may follow to complete the checkout process.

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

        • 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 selected payment method for this cart.

      • 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, ACTIONS_REQUIRED, COMPLETED, CANCELLED, or FAILED.

      • 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 POI was not found.

  • 500

    An unexpected error occurred.

POST /2026-2/carts 
curl \
 --request POST 'https://api.pace.cloud/cart/2026-2/carts' \
 --header "Authorization: Bearer $ACCESS_TOKEN" \
 --header "Content-Type: application/json" \
 --data '{
  "clientId": "pace-drive-app",
  "poiId": "7bf0687b-221d-49a2-a04a-4ec5614aff20",
  "userId": "8fc3698e-84ed-4fb9-8898-0992d5fa703b"
}'
Request examples 
{
  "clientId": "pace-drive-app",
  "poiId": "7bf0687b-221d-49a2-a04a-4ec5614aff20",
  "userId": "8fc3698e-84ed-4fb9-8898-0992d5fa703b"
}
Response examples (201) 
{
  "data": {
    "checkout": {
      "actions": {
        "cartItemId": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
        "default": "7495345",
        "description": "The car mileage is required to complete the cart checkout.",
        "format": "TEXT",
        "label": "Car Mileage",
        "maximum": "100.00",
        "minimum": "10.00",
        "name": "CAR_MILEAGE",
        "optional": false,
        "pattern": "^[0-9]+$",
        "type": "INPUT"
      },
      "actionsUrl": "https://example.com/checkout/actions",
      "cancelledAt": "2023-05-15T14:30:00.000Z",
      "completedAt": "2023-05-15T15:00:00.000Z",
      "failedAt": "2023-05-15T14:30:00.000Z",
      "failureCode": "INSUFFICIENT_FUNDS",
      "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",
    "updatedAt": "2023-05-15T14:15:00.000Z",
    "userId": "e9166a60-1f92-4a5d-a192-c2f6b662e9d9"
  }
}