Inventory

Query and update product stock levels in bulk.

GET /api/v1/inventory Get Stock Levels

curl 'https://rassmi.com/api/v1/inventory' \
  -H 'Authorization: Bearer rsk_your_key'

$inventory = $client->get('/api/v1/inventory', [
    'headers' => ['Authorization' => 'Bearer rsk_your_key'],
]);

const res = await fetch('/api/v1/inventory', {
  headers: { 'Authorization': 'Bearer rsk_your_key' }
});

Http::withToken('rsk_your_key')->get('/api/v1/inventory');

Response 200

{
  "data": [
    {
      "id": "uuid-...",
      "name": "Running Shoes",
      "sku": "SHOES-42-BLK",
      "stock_quantity": 48,
      "price": "4200.00",
      "is_active": true
    }
  ]
}

PUT /api/v1/inventory Update Stock (Bulk)

Update stock quantities for up to 100 products per request. Identify each product by sku or product id.

Request Body

{
  "updates": [
    { "sku": "SHOES-42-BLK", "quantity": 50 },
    { "id": "019ea6a5-0b2f-71f8-8b74-958aae166f5e", "quantity": 12 }
  ]
}

curl -X PUT 'https://rassmi.com/api/v1/inventory' \
  -H 'Authorization: Bearer rsk_your_key' \
  -H 'Content-Type: application/json' \
  -d '{"updates":[{"sku":"SHOES-42-BLK","quantity":50}]}'

$client->put('/api/v1/inventory', [
    'headers' => ['Authorization' => 'Bearer rsk_your_key'],
    'json'    => ['updates' => [['sku' => 'SHOES-42-BLK', 'quantity' => 50]]],
]);

await fetch('/api/v1/inventory', {
  method: 'PUT',
  headers: {
    'Authorization': 'Bearer rsk_your_key',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({ updates: [{ sku: 'SHOES-42-BLK', quantity: 50 }] }),
});

Http::withToken('rsk_your_key')
->put('/api/v1/inventory', [
        'updates' => [['sku' => 'SHOES-42-BLK', 'quantity' => 50]],
    ]);

Response 200

{
  "updated": [
    {
      "id": "uuid-...",
      "sku": "SHOES-42-BLK",
      "stock_quantity": 50
    }
  ],
  "errors": []
}

A 207 Multi-Status is returned when some updates succeed and others fail.