How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Lightspeed Commerce Inventory API

Inventory operations

Lightspeed Commerce Inventory API is one of 58 APIs that Lightspeed Commerce publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Inventory. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an API reference, a getting-started guide, and a changelog.

This API exposes 10 operations across 8 paths, and defines 21 schemas. It is described by OpenAPI 3.2.0, at version 2026-07.

Requests are made against a single base URL, https://{domain_prefix}.retail.lightspeed.app/api/2026-07.

10 operations 8 paths 21 schemas 4 GET5 POST1 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
2026-07
Base URL
https://{domain_prefix}.retail.lightspeed.app
Authentication
HTTP Bearer
License
Terms of Service
Resource Areas
1

Authentication & Security 1

Lightspeed Commerce Inventory API declares 1 security scheme for authenticating requests. It accepts HTTP bearer tokens (bearerAuth). By default, every request must be authenticated.

  • bearerAuth — Bearer Token for API authentication.

Paths & Operations 10

Across 8 paths, the API surfaces 10 operations — 4 GET, 5 POST, 1 PUT. Each is listed below with its method, path, parameters, and response codes.

Inventory 10

Inventory operations

GET
/custom_inventory_adjustment_reasons
List custom inventory adjustment reasons
ListCustomInventoryAdjustmentReasons 3 params → 200401403
POST
/custom_inventory_adjustment_reasons
Create a custom inventory adjustment reason
CreateCustomInventoryAdjustmentReason body → 200400401403409422
PUT
/custom_inventory_adjustment_reasons/{custom_reason_id}
Update a custom inventory adjustment reason
UpdateCustomInventoryAdjustmentReason 1 param body → 200400401403409422
POST
/inventory
List inventory records
ListInventoryRecords body → 200
POST
/inventory/reorder_points
Set reorder points
SetReorderPoints body → 200403422
GET
/inventory/{product_id}
List inventory records for a single product
ListProductInventoryRecords 7 params → 200
POST
/inventory_levels
List inventory levels
ListInventoryLevels body → 200
GET
/inventory_levels/{product_id}
List inventory levels for a single product.
ListProductInventoryLevels 2 params → 200
GET
/stock_adjustments
List stock adjustments
ListStockAdjustments 3 params → 200401403
POST
/stock_adjustments
Create stock adjustments
CreateStockAdjustments body → 201400401403422

Schemas 21

The contract defines 21 schemas that model the data the API accepts and returns. The most detailed are InventoryLevel (15 properties), Inventory (12 properties), InventoryLevelsRequest (12 properties), StockAdjustment (10 properties). Each schema is shown below with its type and property counts.

Version
object
An object containing the highest and lowest version numbers for all items of the returned collection.
2 properties 2 required
StockAdjustmentCollection
object
A paginated list of stock adjustments.
2 properties 2 required
StockAdjustmentBatchResponse
object
The response wrapper for a batch stock adjustment create.
1 property 1 required
InventoryRequest
object
7 properties
CreateStockAdjustmentItem
object
A single stock adjustment to create as part of a batch.
5 properties 4 required
ReorderPointsCollection
object
The response wrapper for the reorder points upsert endpoint.
1 property 1 required
InventoryLevel
object
15 properties
UpdateCustomInventoryAdjustmentReasonRequest
object
Parameters for updating a custom inventory adjustment reason.
2 properties
ReorderPointEntry
object
A reorder point entry returned by the upsert endpoint.
6 properties 4 required
StockAdjustment
object
A recorded stock adjustment.
10 properties 9 required
CustomInventoryAdjustmentReasonSingleton
object
A single custom inventory adjustment reason response.
1 property 1 required
CustomInventoryAdjustmentReasonCollection
object
A paginated list of custom inventory adjustment reasons.
2 properties 2 required
Inventory
object
12 properties
CustomInventoryAdjustmentReason
object
A custom inventory adjustment reason that retailers can use when creating stock adjustments.
8 properties 8 required
ReorderPointMinMaxRequestItem
object
A reorder point entry using the MINMAX method.
5 properties 5 required
CreateStockAdjustmentsRequest
object
A batch of 1–1000 stock adjustments to create.
1 property 1 required
SetReorderPointsRequest
array
An array of reorder point entries to upsert.
ReorderPointFixedRequestItem
object
A reorder point entry using the FIXED method.
5 properties 5 required
InventoryLevelsRequest
object
12 properties
StockAdjustmentReason
string
The reason for a stock adjustment. Negative reasons (require quantity 0): STOCKFOUND, SAMPLEFORSALE. For CUSTOM, the sign must match the referenced custom reas…
CreateCustomInventoryAdjustmentReasonRequest
object
Parameters for creating a new custom inventory adjustment reason.
3 properties 3 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

lightspeed-inventory-api-openapi.yml Raw ↑

Other APIs Lightspeed Commerce publishes across the network.

Lightspeed Retail R-Series API
Lightspeed eCom API
Lightspeed eCom E-Series (Ecwid) API
Lightspeed Restaurant O-Series (Kounta) API
Lightspeed Golf (Chronogolf) Partner API
Lightspeed Commerce Audit API
Lightspeed Commerce Brands API
Lightspeed Commerce Channel Request Log API
Lightspeed Commerce Consignment Products API
Lightspeed Commerce Consignments API
Lightspeed Commerce Customer Addresses API
Lightspeed Commerce Customer Groups API
Where this information came from

This is an independent, third-party profile of Lightspeed Commerce Inventory API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.