Retrieving Collections
Product groupings (mirrors Shopify collections).
Use GET /api/v1/collections to page through every record in your organization, or GET /api/v1/collections/{id} to fetch a single record with its related data. The id is a UUID, and a 404 means it doesn't exist in your organization.
API Endpoint
Current Use Cases
Collections match what you set up in Shopify, so reports and dashboards can group stock the same way your store does.
Roll up counts by collection to see how much of your Summer line or bestsellers is on hand.
Use collections to decide which products go to a marketplace or wholesale catalog.
Check collection names against your other sales channels so nothing gets lost in a rename.
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)