Create a transaction

POST

/transactions

Finds and assigns an available locker for the provided transactionId. Does not open the locker door - use the open endpoint separately when ready.

This operation is idempotent - if the transactionId is already in use, returns the existing transaction (409 status).

Request

Body Params application/jsonRequired

Examples

🟢201Created

application/json

Locker successfully assigned

Body

🟠400Bad Request

🟠409Conflict

🔴500Internal Server Error

🔴503Service Unavailable

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST '/transactions' \
--header 'Content-Type: application/json' \
--data-raw '{
    "transactionId": "string"
}'

Response Example

201 - Example 1

{
    "transactionId": "string",
    "lockerId": 0,
    "createdAt": "2019-08-24T14:15:22Z"
}

Modified at 2025-11-27 00:04:50