---
title: "Get cart pre-authorization"
method: GET
path: "/v3/checkout/shoppingCarts/{shoppingCartId}/preauth"
tags: ["ShoppingCart"]
---

# Get cart pre-authorization

`GET /v3/checkout/shoppingCarts/{shoppingCartId}/preauth`

## Request

- Base URL: `https://marketplace.appdirect.com/api`
- URL: `https://marketplace.appdirect.com/api/v3/checkout/shoppingCarts/{shoppingCartId}/preauth`
- Auth: none declared
- TypeScript: <https://skmtc.dev/appdirect/apis/companies/docs/v3/checkout/shoppingCarts/:shoppingCartId/preauth/get.ts> (a function with typed inputs; its response is checked against the schema)

Retrieves the payment pre-authorization for the specified cart.

## Path parameters

- `shoppingCartId` string, required

## Response `200`

Payment pre-authorization response

- PreAuth
  - `preAuthId` string: Pre-authorization ID from the payment service
  - `status` 'SUCCESS' | 'FAILURE' | 'NOT_SUPPORTED' | 'ERROR' | 'PROCESSING'
  - `message` string: Message returned from the payment gateway.
  - `code` string: Code returned from the payment gateway.

## Other responses

- `400`: Bad request
- `500`: Unknown error

## Changes

- **2026-11-06** `1fc240f06971`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/appdirect/apis/companies/changes/v3/checkout/shoppingCarts/:shoppingCartId/preauth/get.md)

---

[API](https://skmtc.dev/appdirect/apis/companies.md) - [All operations](https://skmtc.dev/appdirect/apis/companies/llms.txt) - [OpenAPI document](https://skmtc.dev/appdirect/apis/companies/revisions/1fc240f06971?raw)