Retrieving Certificates of Analysis
Lab COAs and other compliance documents, optionally linked to a SKU.
Use GET /api/v1/coas to page through every record in your organization, or GET /api/v1/coas/{id} to fetch a single record. The id is a string, and a 404 means it doesn't exist in your organization.
API Endpoint
Current Use Cases
Pull the COA linked to a SKU so the lab result follows that batch into your store or menu.
Filter by result to find batches that failed testing before they get pulled for an order.
Search by batch to hand an inspector the right document in seconds instead of digging through folders.
Link the COA to a product page or QR code so buyers can see the lab results themselves.
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)