Retrieving Alerts
Stock, weight, and device alerts.
Use GET /api/v1/alerts to page through every record in your organization, or GET /api/v1/alerts/{id} to fetch a single record. The id is a UUID, and a 404 means it doesn't exist in your organization.
API Endpoint
Current Use Cases
Poll for unviewed alerts and push low-stock or device warnings to the channel your team already watches.
Turn device alerts into tickets in your help desk so someone actually goes and fixes the scale.
Filter by sku_id to see how often an item runs low and adjust its par level.
Pull alerts with created_since to review a week or month of issues in one place.
Required Headers
Every request must include the following:
Requests missing either header will return 401 Unauthorized
Example Request
Response Schema
Filters
Errors
Cloudbox uses standard HTTP status codes to indicate API success or failure:
- 200–299 – Request succeeded
- 400 – Bad request (missing parameters, invalid values)
- 401 – Unauthorized (missing or invalid API keys)
- 404 – Resource not found
- 429 – Too many requests (rate limited)