List inventory adjustments (audit trail)

Inventory adjustments (audit trail)

GET /v1/tenants/{tenant_id}/inventory/adjustments

cURL

curl --request GET \
  --url 'https://api.sync.stateset.com/v1/tenants/{tenant_id}/inventory/adjustments' \
  --header "x-stateset-api-key: $STATESET_SYNC_API_KEY"

200

{
  "items": [
    {
      "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "sku": "SKU-TENT-2P-GRN",
      "location": "string",
      "source": "string",
      "quantityBefore": 1,
      "quantityAfter": 1,
      "quantityDelta": 1,
      "reason": "Two-person tent, green — replacement for damaged pole set.",
      "reasonDetails": "string",
      "referenceType": "string",
      "referenceId": "string",
      "externalId": "string",
      "metadata": {},
      "createdAt": "2026-08-31T14:22:05Z",
      "createdBy": "string",
      "syncedToShopify": true,
      "syncedToNetsuite": true,
      "syncError": "string"
    }
  ],
  "pagination": {
    "page": 1,
    "pageSize": 20,
    "totalItems": 1,
    "totalPages": 1,
    "hasNext": true,
    "hasPrevious": true
  }
}

Path parameters

tenant_id · string · required

Tenant identifier

Query parameters

page · integer (int32)

Page number (1-indexed)

page_size · integer (int32)

Items per page (max 100)

sku · string

Filter by SKU

location · string

Filter by location

source · string

Filter by source system

reason · string

Filter by adjustment reason

reference_type · string

Filter by reference type (order, webhook, sync_job, reservation)

reference_id · string

Filter by reference id

since · string

Filter by created_at (RFC3339 timestamp)

Response

object

items · object[] · required

The items on this page

Show items

id · string (uuid) · required

sku · string · required

location · string · required

source · string · required

quantityBefore · integer

quantityAfter · integer

quantityDelta · integer · required

reason · string · required

reasonDetails · string

referenceType · string

referenceId · string

externalId · string

metadata · object · required

createdAt · string (date-time) · required

createdBy · string · required

syncedToShopify · boolean · required

syncedToNetsuite · boolean · required

syncError · string

pagination · object · required

Pagination metadata

Show pagination

page · integer · required

Current page number

pageSize · integer · required

Number of items per page

totalItems · integer

Total number of items across all pages

totalPages · integer

Total number of pages

hasNext · boolean · required

Whether there is a next page

hasPrevious · boolean · required

Whether there is a previous page

Status codes

Code	Meaning
200	Inventory adjustments (audit trail)
401	Unauthorized
424	Database not configured

cURL

curl --request GET \
  --url 'https://api.sync.stateset.com/v1/tenants/{tenant_id}/inventory/adjustments' \
  --header "x-stateset-api-key: $STATESET_SYNC_API_KEY"

200

{
  "items": [
    {
      "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "sku": "SKU-TENT-2P-GRN",
      "location": "string",
      "source": "string",
      "quantityBefore": 1,
      "quantityAfter": 1,
      "quantityDelta": 1,
      "reason": "Two-person tent, green — replacement for damaged pole set.",
      "reasonDetails": "string",
      "referenceType": "string",
      "referenceId": "string",
      "externalId": "string",
      "metadata": {},
      "createdAt": "2026-08-31T14:22:05Z",
      "createdBy": "string",
      "syncedToShopify": true,
      "syncedToNetsuite": true,
      "syncError": "string"
    }
  ],
  "pagination": {
    "page": 1,
    "pageSize": 20,
    "totalItems": 1,
    "totalPages": 1,
    "hasNext": true,
    "hasPrevious": true
  }
}