> ## Documentation Index
> Fetch the complete documentation index at: https://docs.stateset.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Check low stock alerts

> Low stock alerts

### Path parameters

<ParamField path="tenant_id" type="string" required>
  Tenant identifier
</ParamField>

### Query parameters

<ParamField query="threshold" type="integer (int64)">
  Stock threshold (default: 10)
</ParamField>

### Response

`object[]` — each element:

<ResponseField name="sku" type="string" required />

<ResponseField name="currentQuantity" type="integer" required />

<ResponseField name="threshold" type="integer" required />

<ResponseField name="location" type="string" required />

<ResponseField name="detectedAt" type="string (date-time)" required />

### Status codes

| Code  | Meaning          |
| ----- | ---------------- |
| `200` | Low stock alerts |
| `401` | Unauthorized     |

<RequestExample>
  ```bash cURL theme={null}
  curl --request GET \
    --url 'https://api.sync.stateset.com/v1/tenants/{tenant_id}/inventory/alerts' \
    --header 'x-stateset-api-key: YOUR_API_KEY'
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  [
    {
      "sku": "SKU-TENT-2P-GRN",
      "currentQuantity": 1,
      "threshold": 1,
      "location": "string",
      "detectedAt": "2026-08-31T14:22:05Z"
    }
  ]
  ```
</ResponseExample>