Returns a paginated list of carts. | Cart API documentation (2025-3)

Returns a paginated list of carts. 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

{
  "Cart MCP server": {
    "url": "https://developer.pace.cloud/doc/cart/mcp"
  }
}

GET /2025-3/carts

Oauth2 Oauth2

Returns a paginated list of carts.

Query parameters

filter object

Filter for the carts.
Hide filter attributes Show filter attributes object
- clientId object
  
  Filter for the client ID.
  Hide clientId attribute Show clientId attribute object
  
  eq string
- poiId object
  
  Filter for the POI ID.
  Hide poiId attribute Show poiId attribute object
  
  eq string(uuid)
- status object
  
  Filter for the status.
  Hide status attributes Show status attributes object
  
  eq string
  
  Values are PENDING, CANCELLED, CHECKOUT_PROCESSING, CHECKOUT_FAILED, CHECKOUT_COMPLETED, or CHECKOUT_CANCELLED.
  
  in array[string]
  
  Values are PENDING, CANCELLED, CHECKOUT_PROCESSING, CHECKOUT_FAILED, CHECKOUT_COMPLETED, or CHECKOUT_CANCELLED.
- userId object
  
  Filter for the user ID.
  Hide userId attribute Show userId attribute object
  
  eq string(uuid)
page object

The pagination details for the list of carts.
Hide page attributes Show page attributes object
- number integer
  
  The page number to return.
  
  Minimum value is 0. Default value is 0.
- size integer
  
  Number of items to return per page.
  
  Minimum value is 1. Default value is 10.

Responses

200 application/json

Successfully retrieved the list of carts.
Hide response attributes Show response attributes object
- data array[object] Required
  
  The list of carts for the current page.
  
  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.
- page object Required
  
  The pagination details for the list of carts.
  
  Hide page attributes Show page attributes object
  
  count integer Required
  
  Number of items on the current page.
  
  number integer Required
  
  Current page number.
  
  size integer Required
  
  Number of items per page.
  
  total integer Required
  
  Total number of items across all pages.
401

Client authentication failed.
403

Missing one or more required scopes.
500

An unexpected error occurred.

GET /2025-3/carts

curl \
 --request GET 'https://api.dev.pace.cloud/cart/2025-3/carts' \
 --header "Authorization: Bearer $ACCESS_TOKEN"

Response examples (200)

{
  "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"
    }
  ],
  "page": {
    "count": 7,
    "number": 0,
    "size": 10,
    "total": 13
  }
}