Returns a paginated list of carts.

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

Oauth2 Oauth2

Returns a paginated list of carts.

Query parameters

filter object | string

Filter for the carts.
page object | string

The pagination details for the list of carts.

Responses

200 application/json

Successfully retrieved the list of carts.
Hide response attribute Show response attribute object
- data array[object] Required
  
  The list of carts for the current page.
  
  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
  
  Hide attributes Show attributes
  
  cartItemId string(uuid) | null Required
  
  The unique identifier of the cart item this action is scoped to, or null if the action applies to the entire transaction.
  
  default string | null Required
  
  The default value of the action if no value is provided.
  
  description string | null Required
  
  The description of the action that is required for the cart checkout.
  
  format string Required
  
  The expected format of the input value.
  
  Values are TEXT, DECIMAL, or EMAIL.
  
  label string Required
  
  The localized label of the action.
  
  maximum string(decimal) | null Required
  
  The inclusive maximum value of the action when the format is DECIMAL. Ignored for other formats.
  
  minimum string(decimal) | null Required
  
  The inclusive minimum value of the action when the format is DECIMAL. Ignored for other formats.
  
  name string Required
  
  The name of the action that is required for the cart checkout.
  
  optional boolean Required
  
  Whether the action is optional and does not need to be provided by the client.
  
  pattern string | null Required
  
  The regular expression pattern that the action value must match. May be combined with any format.
  
  type string Required Discriminator
  
  The discriminator type of the action.
  
  Value is INPUT.
  
  Hide attributes Show attributes
  
  cartItemId string(uuid) | null Required
  
  The unique identifier of the cart item this action is scoped to, or null if the action applies to the entire transaction.
  
  description string | null Required
  
  The description of the action that is required for the cart checkout.
  
  label string Required
  
  The localized label of the action.
  
  name string Required
  
  The name of the action that is required for the cart checkout.
  
  optional boolean Required
  
  Whether the action is optional and does not need to be provided by the client.
  
  options array[object] Required
  
  The available options for the action.
  
  Hide options attributes Show options attributes object
  
  detail string | null Required
  
  The localized detail of the option.
  
  disabled boolean Required
  
  Whether the option is disabled and cannot be selected.
  
  icon object Required
  
  The icon URLs for the option.
  
  Hide icon attributes Show icon attributes object
  
  dark string(uri) | null Required
  
  The icon URL for the option in dark mode. Falls back to the default icon if not provided.
  
  default string(uri) Required
  
  The default icon URL for the option.
  
  text string Required
  
  The localized text of the option.
  
  title string | null Required
  
  The localized title of the option.
  
  value string Required
  
  The technical value of the option used for submission.
  
  type string Required Discriminator
  
  The discriminator type of the action.
  
  Value is MULTI_SELECT.
  
  Hide attributes Show attributes
  
  cartItemId string(uuid) | null Required
  
  The unique identifier of the cart item this action is scoped to, or null if the action applies to the entire transaction.
  
  description string | null Required
  
  The description of the action that is required for the cart checkout.
  
  label string Required
  
  The localized label of the action.
  
  name string Required
  
  The name of the action that is required for the cart checkout.
  
  optional boolean Required
  
  Whether the action is optional and does not need to be provided by the client.
  
  options object Required
  The alternatives the user can choose between. Exactly one of them must be answered.
  
  One of:
  INPUT object MULTI_SELECT object SINGLE_SELECT object
  
  Hide attributes Show attributes
  
  cartItemId string(uuid) | null Required
  
  The unique identifier of the cart item this action is scoped to, or null if the action applies to the entire transaction.
  
  default string | null Required
  
  The default value of the action if no value is provided.
  
  description string | null Required
  
  The description of the action that is required for the cart checkout.
  
  format string Required
  
  The expected format of the input value.
  
  Values are TEXT, DECIMAL, or EMAIL.
  
  label string Required
  
  The localized label of the action.
  
  maximum string(decimal) | null Required
  
  The inclusive maximum value of the action when the format is DECIMAL. Ignored for other formats.
  
  minimum string(decimal) | null Required
  
  The inclusive minimum value of the action when the format is DECIMAL. Ignored for other formats.
  
  name string Required
  
  The name of the action that is required for the cart checkout.
  
  optional boolean Required
  
  Whether the action is optional and does not need to be provided by the client.
  
  pattern string | null Required
  
  The regular expression pattern that the action value must match. May be combined with any format.
  
  type string Required Discriminator
  
  The discriminator type of the action.
  
  Value is INPUT.
  
  Hide attributes Show attributes
  
  cartItemId string(uuid) | null Required
  
  The unique identifier of the cart item this action is scoped to, or null if the action applies to the entire transaction.
  
  description string | null Required
  
  The description of the action that is required for the cart checkout.
  
  label string Required
  
  The localized label of the action.
  
  name string Required
  
  The name of the action that is required for the cart checkout.
  
  optional boolean Required
  
  Whether the action is optional and does not need to be provided by the client.
  
  options array[object] Required
  
  The available options for the action.
  
  Hide options attributes Show options attributes object
  
  detail string | null Required
  
  The localized detail of the option.
  
  disabled boolean Required
  
  Whether the option is disabled and cannot be selected.
  
  icon object Required
  
  The icon URLs for the option.
  
  Hide icon attributes Show icon attributes object
  
  dark string(uri) | null Required
  
  The icon URL for the option in dark mode. Falls back to the default icon if not provided.
  
  default string(uri) Required
  
  The default icon URL for the option.
  
  text string Required
  
  The localized text of the option.
  
  title string | null Required
  
  The localized title of the option.
  
  value string Required
  
  The technical value of the option used for submission.
  
  type string Required Discriminator
  
  The discriminator type of the action.
  
  Value is MULTI_SELECT.
  
  Hide attributes Show attributes
  
  cartItemId string(uuid) | null Required
  
  The unique identifier of the cart item this action is scoped to, or null if the action applies to the entire transaction.
  
  description string | null Required
  
  The description of the action that is required for the cart checkout.
  
  label string Required
  
  The localized label of the action.
  
  name string Required
  
  The name of the action that is required for the cart checkout.
  
  optional boolean Required
  
  Whether the action is optional and does not need to be provided by the client.
  
  options array[object] Required
  
  The available options for the action.
  
  Hide options attributes Show options attributes object
  
  detail string | null Required
  
  The localized detail of the option.
  
  disabled boolean Required
  
  Whether the option is disabled and cannot be selected.
  
  icon object Required
  
  The icon URLs for the option.
  
  Hide icon attributes Show icon attributes object
  
  dark string(uri) | null Required
  
  The icon URL for the option in dark mode. Falls back to the default icon if not provided.
  
  default string(uri) Required
  
  The default icon URL for the option.
  
  text string Required
  
  The localized text of the option.
  
  title string | null Required
  
  The localized title of the option.
  
  value string Required
  
  The technical value of the option used for submission.
  
  type string Required Discriminator
  
  The discriminator type of the action.
  
  Value is SINGLE_SELECT.
  
  type string Required Discriminator
  
  The type of the action.
  
  Value is ONE_OF.
  
  Hide attributes Show attributes
  
  cartItemId string(uuid) | null Required
  
  The unique identifier of the cart item this action is scoped to, or null if the action applies to the entire transaction.
  
  description string | null Required
  
  The description of the action that is required for the cart checkout.
  
  label string Required
  
  The localized label of the action.
  
  name string Required
  
  The name of the action that is required for the cart checkout.
  
  optional boolean Required
  
  Whether the action is optional and does not need to be provided by the client.
  
  options array[object] Required
  
  The available options for the action.
  
  Hide options attributes Show options attributes object
  
  detail string | null Required
  
  The localized detail of the option.
  
  disabled boolean Required
  
  Whether the option is disabled and cannot be selected.
  
  icon object Required
  
  The icon URLs for the option.
  
  Hide icon attributes Show icon attributes object
  
  dark string(uri) | null Required
  
  The icon URL for the option in dark mode. Falls back to the default icon if not provided.
  
  default string(uri) Required
  
  The default icon URL for the option.
  
  text string Required
  
  The localized text of the option.
  
  title string | null Required
  
  The localized title of the option.
  
  value string Required
  
  The technical value of the option used for submission.
  
  type string Required Discriminator
  
  The discriminator type of the action.
  
  Value is SINGLE_SELECT.
  
  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.
500

An unexpected error occurred.

GET /2026-2/carts

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

Response examples (200)

{
  "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"
    }
  ]
}