Initiate Async Purchase

POST

https://api.lootlocker.com/game/purchase/inspired-ibex/v1

Creates a pending entitlement and begins processing the purchase in the background. Returns immediately with the entitlement ID. Poll GET /{entitlement_id} for status.

Validation (items, wallet ownership, game settings) is performed synchronously before the 202 response. Only failures that emerge during the actual purchase flow (insufficient funds, catalog changes) are reported via the status endpoint.

Request

Authorization

API Key

Add parameter in header

x-session-token

Example:

x-session-token: ********************

Body Params application/jsonRequired

Examples

Responses

🟢202

application/json

Purchase accepted and processing in background

Bodyapplication/json

🟠400

🟠403

🟠404

🔴500InternalError

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api.lootlocker.com/game/purchase/inspired-ibex/v1' \
--header 'x-session-token: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
    "items": [
        {
            "catalog_listing_id": "01KHWDKA4KYJS6TKDSSMQJFAHS",
            "quantity": 2
        }
    ],
    "wallet_id": ""
}'

Response Example

202 - Success

{
    "success": true,
    "entitlement_id": "01JMHKA2E5F7G9H0J1K2L3M4N5"
}

Modified at 2026-07-02 09:05:45

Refund items by Entitlement IDs

Poll Purchase Status