Skip to content

Confirm Reservation

POST /inventory/reservations/{id}/confirm action bearer

Confirms a Reservation, converting it to a firm commitment and triggering allocation at the fulfillment node.


Overview

ID confirm-reservation-api
Method POST
Path /inventory/reservations/{id}/confirm
Classification action
Domain inventory
Capability inventory-reservation
Service confirm-reservation
Application sim — SIM
Auth bearer

Response

Business Object reservation
Description Temporary hold on inventory for a customer, basket, order, or fulfillment flow.
Lifecycle requested → confirmed → fulfilled → expired → cancelled → released

Events Emitted

Event Classification Object Description
reservation-confirmed transitioned reservation A soft reservation was confirmed as a hard allocation.

Scenarios using inventory-reservation

Scenario Description
Buy Online, Pick Up In Store Customer browses and purchases online, then collects the order from a physical store. The canonical
Exchange Anywhere Customer exchanges an item purchased in any channel at any supported touchpoint. The original item i
Reserve and Collect Customer reserves stock online for in-store collection without paying at the time of reservation. Th
Ship From Store An online order is fulfilled by shipping the goods directly from a physical store rather than a cent
API Method Path Type
Get Inventory GET /inventory/items/{sku} query
Reserve Inventory POST /inventory/reservations command
Release Reservation DELETE /inventory/reservations/{id} action
Get Stock Locations GET /stock/{sku}/locations query
Check Availability GET /inventory/{sku}/availability query
Allocate Inventory POST /inventory/allocate command