SKU Vendors API

Get access to your sku vendors data through Cloudbox's v1 API.

Retrieving SKU Vendors

Which vendors supply which SKUs, with the vendor's item code, price, lead time, and MOQ.

Use GET /api/v1/sku-vendors to page through every record in your organization, or GET /api/v1/sku-vendors/{id} to fetch a single record. The id is a UUID, and a 404 means it doesn't exist in your organization.

API Endpoint

GET
/api/v1/sku-vendors
GET
/api/v1/sku-vendors/{id}

Required Headers

Every request must include the following:

Header Key
Description
org-api-key
Your Organization API key. Contact Cloudbox Support For Access: support@cloudboxapp.com.
user-api-key
Your User API Key

Requests missing either header will return 401 Unauthorized

Example Request

bash curl -X GET "https://app.cloudboxapp.com/api/v1/sku-vendors?limit=100" \ -H "org-api-key: YOUR_ORG_API_KEY" \ -H "user-api-key: YOUR_USER_API_KEY" \ -H "Accept: application/json"

Response Schema

Column
Type
Description
id
string (uuid)
Unique ID
sku_id
string
References SKU. Filterable (exact)
vendor_id
string (uuid)
References Vendors. Filterable (exact)
vendor_sku_code
string, nullable
Filterable (exact)
unit_price
number, nullable
lead_time_days
integer, nullable
min_order_qty
number, nullable
is_primary
boolean, nullable
Filterable (exact)
notes
string, nullable
created_at
string (ISO 8601)
Creation timestamp (UTC). Sortable
updated_at
string (ISO 8601)
Last update timestamp (UTC). Sortable

Filters

limitPage size (default 100, max 1000)
offsetNumber of records to skip (default 0)
sortOne of: created_at, updated_at
orderasc | desc
sku_idVendors for this SKU
vendor_idSKUs supplied by this vendor
vendor_sku_codeExact vendor item code match
is_primaryOnly primary (true) or non-primary (false) vendors (boolean)
updated_sinceOnly records updated at or after this ISO 8601 timestamp
default sortcreated_at descending

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)