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).

Concurrency: Under high load, multiple simultaneous requests may attempt to assign the same locker. When this occurs, one request succeeds (201) while others receive 503 LOCKER_ASSIGNMENT_CONFLICT. Clients should implement retry logic with exponential backoff (typically 100ms, 200ms, 400ms).

Request

Body Params application/jsonRequired

Examples

Responses

🟢201

application/json

Locker successfully assigned

Body

🟠400

🟠409

🔴500

🔴503

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST '/transactions' \
--header 'Content-Type: application/json' \
--data-raw '{
    "transactionId": "string",
    "preferredLockerType": "medium",
    "preferredAttributes": [
        "low"
    ],
    "widthInches": 18,
    "heightInches": 24,
    "lengthInches": 12,
    "allowFallback": true,
    "attributesRequired": true,
    "matchingStrategy": "do_not_tip"
}'

Response Example

201 - Example 1

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

Modified at 2026-02-20 22:56:40

List all transactions

Get transaction details