Inventory

Programmatically manages a Square sellers inventory of catalog items.

The Inventory API allows you to programmatically manage inventory counts and inventory changes of products or services.

For more information, see the following guides:

API version2026-08-19

All versions ->

List inventory adjustment reasons

GET/v2/inventory/adjustment-reasons

Returns the standard and custom inventory adjustment reasons available to the seller.

Beta

Create inventory adjustment reason

POST/v2/inventory/adjustment-reasons/create

Creates a custom inventory adjustment reason.

Beta

Delete inventory adjustment reason

POST/v2/inventory/adjustment-reasons/delete

Soft deletes a custom inventory adjustment reason.

Beta

Restore inventory adjustment reason

POST/v2/inventory/adjustment-reasons/restore

Restores a soft-deleted custom inventory adjustment reason.

Beta

Retrieve inventory adjustment reason

POST/v2/inventory/adjustment-reasons/retrieve

Returns the inventory adjustment reason identified by the provided reason_id.

Beta

Update inventory adjustment reason

PUT/v2/inventory/adjustment-reasons/update

Updates a custom inventory adjustment reason.

Beta

Update inventory adjustment

PUT/v2/inventory/adjustments/update

Applies an update to the provided adjustment.

Beta

Retrieve inventory adjustment

GET/v2/inventory/adjustments/{adjustment_id}

Returns the InventoryAdjustment object with the provided adjustment_id.

Batch change inventory

POST/v2/inventory/changes/batch-create

Applies adjustments and counts to the provided item quantities.

Batch retrieve inventory changes

POST/v2/inventory/changes/batch-retrieve

Returns historical physical counts and adjustments based on the provided filter criteria.

Batch retrieve inventory counts

POST/v2/inventory/counts/batch-retrieve

Returns current counts for the provided CatalogObjects at the requested Locations.

Retrieve inventory physical count

GET/v2/inventory/physical-counts/{physical_count_id}

Returns the InventoryPhysicalCount object with the provided physicalcountid.

Retrieve inventory count

GET/v2/inventory/{catalog_object_id}

Retrieves the current calculated stock count for a given CatalogObject at a given set of Locations.