Checks whether the requested cart lines can be reserved without actually reserving stock. Performs an in-memory sequential reservation simulation, where each line reduces the available stock for subsequent lines (same as the real reservation flow). Return

POST

/api/reservations/check

This endpoint is intentionally unauthenticated — it is called service-to-service
by Cart API's stock validator through the gateway.

Request

Header Params

Body Params application/jsonRequired

Example

{
    "lines": [
        {
            "lineId": "string",
            "productId": "string",
            "productVariantId": "string",
            "quantity": 0
        }
    ]
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://platform.shopranos.eu/api/reservations/check' \
--header 'x-companyId: b3e68ad4-06c8-4e70-965b-c02b38f66ef2' \
--header 'x-storeId;' \
--header 'Content-Type: application/json' \
--data '{
    "lines": [
        {
            "lineId": "string",
            "productId": "string",
            "productVariantId": "string",
            "quantity": 0
        }
    ]
}'

Responses

🟢200

application/json

Per-line reservation feasibility report.

Bodyapplication/json

Example

{
    "canReserveAll": true,
    "lines": [
        {
            "lineId": "string",
            "productId": "string",
            "productVariantId": "string",
            "requestedQuantity": 0,
            "canReserve": true
        }
    ]
}

🟠400

Modified at 2026-06-12 11:38:10

Adjust reserved stock for a cart in eshop

Cancel cardlink payment