Create a new 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
POST /2025-3/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
      • cancelledAt string(date-time) | null Required

        The timestamp when the cart was cancelled.

      • clientId string(uuid) Required

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

      • completedAt string(date-time) | null Required

        The timestamp when the cart checkout was completed.

      • createdAt string(date-time) Required

        The timestamp when the cart was created.

      • expiresAt string(date-time) | null Required

        The timestamp when the cart will expire.

      • 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 Point of interest associated with this cart.

      • status string Required

        The current status of the cart.

        Values are PENDING, CANCELLED, CHECKOUT_PROCESSING, CHECKOUT_FAILED, CHECKOUT_COMPLETED, or CHECKOUT_CANCELLED.

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

    Client authentication failed.

  • 403

    Missing one or more required scopes.

  • 500

    An unexpected error occurred.

POST /2025-3/carts 
curl \
 --request POST 'https://api.dev.pace.cloud/cart/2025-3/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": {
    "cancelledAt": "2023-05-15T14:30:00.000Z",
    "clientId": "0feb6be6-7314-469b-83ac-5b9b7e4b4a4e",
    "completedAt": "2023-05-15T15:00:00.000Z",
    "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": "PENDING",
    "updatedAt": "2023-05-15T14:15:00.000Z",
    "userId": "e9166a60-1f92-4a5d-a192-c2f6b662e9d9"
  }
}