Retrieving Vendors
Suppliers, with contacts, addresses, and the SKUs they supply.
Use GET /api/v1/vendors to page through every record in your organization, or GET /api/v1/vendors/{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
Send vendors with their contacts and addresses to QuickBooks or your ERP so bills match.
Pull every active vendor into an internal contact list for purchasing.
Use the vendor's SKU list to know who to call when an item runs low.
Filter by category to compare suppliers for packaging, raw materials, or other spend.
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)