.avif)
Retrieving Inventory Data
The first step in syncing CloudBox inventory into your system is retrieving your organization’s SKU list. SKUs represent the products your CloudBox containers are tracking, and include metadata such as unit weights, category, expiration dates, descriptions, and tracking IDs.The CloudBox API exposes a dedicated endpoint to export all SKU records associated with your organization.
API Endpoint
You may need to indicate that a piece of text is to be used in code or an attribute.
GET /api/export/skus
Required Headers
Every request must include the following:
Requests missing either header will return 401 Unauthorized
Example Request
bash
curl -X GET "https://app.cloudboxapp.com/api/export/skus" \
-H "org-api-key: YOUR_ORG_API_KEY" \
-H "user-api-key: YOUR_USER_API_KEY" \
-H "Accept: application/json"
Response Schema
Example Request
json
[
{
"id": "sku_123",
"name": "Example Product",
"category": "Flower",
"unitWeight": 3.5,
"trackingId": "ABC123",
"unitModeEnabled": true,
"expirationDate": "2025-12-31",
"description": "Sample SKU",
"organizationId": "org_456",
"createdAt": "2025-01-01T10:00:00Z",
"updatedAt": "2025-01-10T15:30:00Z",
"uploadedSKU": false,
"promptUser": false
}
]
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)
.png)
