Repository navigation
Vendor Products List
Manage vendor-specific product offerings in multi-vendor shops. In a marketplace, each vendor that sells a product has its own vendor product (an offer) with its own price, quantity, variant and lead time. This page shows how to list those offers; the related pages show how to add, update and delete them.
Base URL:
https://api.selldone.comAuth header:Authorization: Bearer YOUR_ACCESS_TOKEN
Retrieve a paginated list of the vendor offers for a specific product in your marketplace.
GET /shops/{shop_id}/products/{product_id}/vendors
JavaScript SDK equivalent:
const { vendor_products, total } =
await window.$backoffice.product.vendor.list(shop_id, product_id, offset, limit, options);| Name | Type | Required | Description |
|---|---|---|---|
offset |
number | No | Starting index for pagination (default: 0). |
limit |
number | No | Number of records to return (max: 200). |
sortBy |
string | No | Field to sort by (default: created_at). |
sortDesc |
boolean | No | Sort descending if true (default: true). |
search |
string | No | Search vendors by name, description and similar fields. |
vendor_id |
number | No | Filter results to a specific vendor. |
Your token needs the backoffice:product:read scope.
GET https://api.selldone.com/shops/123/products/456/vendors?limit=10&sortDesc=true
Authorization: Bearer YOUR_ACCESS_TOKEN{
"vendor_products": [
{
"id": 77,
"vendor": {
"id": 5,
"name": "EcoMarket",
"icon": "https://..."
},
"quantity": 40,
"price": 9.99,
"currency": "USD",
"enable": true,
"variant": {...},
"pricing": {...},
"product": {...}
}
],
"total": 1
}To change the price, availability or other data of one vendor's offer, use
PUT /shops/{shop_id}/products/{product_id}/vendors/{vendor_product_id}. The body parameters, pricing rules and
errors are documented on Vendor Product Update.
- Use these APIs to manage inventory and pricing per vendor in marketplaces.
- These endpoints are for the marketplace owner. Vendors manage their own products from a vendor panel built with the Vendor SDK, or ask the shop owner to update their offer.
- Always check whether
variant_idis required (the product has variants) before assigning a product to a vendor. - The global Edit Product endpoint does not change vendor-specific price, stock or lead time.
-
Vendor Product Add:
POST /shops/{shop_id}/products/{product_id}/vendors -
Vendor Product Update:
PUT /shops/{shop_id}/products/{product_id}/vendors/{vendor_product_id} -
Vendor Product Delete:
DELETE /shops/{shop_id}/products/{product_id}/vendors/{vendor_product_id} -
Get Vendors List:
GET /shops/{shop_id}/vendors
Guides
Products
- Fetch Products List
- Edit Product
- Edit Product's Variant
- Add Images to Products/Variants
- Upload Products Category Image
Marketplace vendors
- Get Vendors List
- Vendor Products List
- Vendor Product Add
- Vendor Product Update
- Vendor Product Delete
Ecosystem
Links