API Reference

Create stock adjustments

post
https://{domain_prefix}.retail.lightspeed.app/api/2026-01/stock_adjustments

Creates one or more stock adjustments in a single batch (1–1000 items per request).

🔒 Requires: inventory:write scope

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params

A batch of 1–1000 stock adjustments to create.

stock_adjustments
array of objects
required
length between 1 and 1000

The stock adjustments to create.

stock_adjustments*

A single stock adjustment to create as part of a batch.

uuid
length between 1 and 36

Required when reason is CUSTOM; must be omitted otherwise.

uuid
required
length between 1 and 36

The ID of the outlet where the adjustment is recorded.

uuid
required
length between 1 and 36

The ID of the product to adjust.

string
required
length ≤ 32

Quantity to adjust. Must be a numeric string (e.g. "1" or "-3"). Negative for DAMAGE/EXPIRY/etc., positive for STOCK_FOUND/SAMPLE_FOR_SALE.

string
enum
required

The reason for a stock adjustment.

Negative reasons (require quantity < 0): DAMAGE, EXPIRY, INTERNAL_USE, THEFT, DONATION.
Positive reasons (require quantity > 0): STOCK_FOUND, SAMPLE_FOR_SALE.
For CUSTOM, the sign must match the referenced custom reason's type.

Responses

400

Bad Request

401

Unauthorized

403

Forbidden

Updated 3 months ago

Did this page help you?
Language
Credentials
Bearer
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated 3 months ago

Did this page help you?