1. Products
Marketplace
  • Getting an API token
  • Introduction
  • Customers
    • Get a list of Customer Fields
    • Retrieve Customer Fields matching the given ID
    • Get a list of Customers
    • Retrieve Customers matching the given ID
    • Update a Customer
    • Delete a Customer
    • Bulk Add/Update Customers
    • Create a new Customer
    • Get a list of Orders
  • Distributors
    • Get a list of Distributors
    • Retrieve Distributors matching the given ID
    • Update a Distributor
    • Delete a Distributor
    • Create a new Distributor
  • Warehouses
    • Get a list of Warehouses
    • Retrieve Warehouses matching the given ID
    • Update a Warehouse
    • Delete a Warehouse
    • Bulk Add/Update Warehouses
    • Create a new Warehouse
  • Exports
    • Get available exports
    • Get parameter options
    • Run custom export
  • Orders
    • Get a list of Order Batches
    • Retrieve Order Batch matching the given order batch Ids (from orderBatches/list)
    • Update Order Batch status
    • Delete Order Batch
    • Create a new Order
    • Update an existing Order
    • Bulk Add/Update Orders
    • Bulk Update Order Batch Statuses
  • People
    • Get a list of People
    • Retrieve a specific Person by ID
    • Update a Person
    • Delete a Person
    • Create a new Person
    • Bulk Add/Update Persons
    • Get a list of roles
    • Get a list of person types
    • Retrieve a specific Person Type by ID
  • Products
    • Get a list of Products
      GET
    • Create a new Product
      POST
    • Bulk Add/Update Products
      POST
    • Retrieve Products matching the given ID
      GET
    • Update a Product
      PUT
    • Delete a Product
      DELETE
    • Get a list of Product Skus
      GET
    • Create a new Product Sku
      POST
    • Update a Product Sku
      PUT
    • Bulk Add/Update Product Skus
      POST
    • Get a list of Pricing information for a given product
      GET
    • Bulk Add/Update Pricing
      POST
    • Get a list of categories
      GET
    • Get a list of brands
      GET
    • Get a list of PriceZones
      GET
    • Get a list of Product Fields
      GET
    • Get a list of Product Sku Fields
      GET
    • Get a list of product options
      GET
    • Retrieve a product option matching the given ID
      GET
    • Update a product option
      PUT
    • Delete a product option
      DELETE
    • Create a new product option
      POST
    • Update Pricing for a product that starts on a given date
      PUT
    • Create new Pricing for a product
      POST
    • Delete Pricing for a product that starts on a given date
      DELETE
    • Retrieve a field matching the given ID
      GET
    • Add or update the component SKUs linked to a kit Product
      POST
    • Bulk Add/Update the component SKUs linked to kit Products, across any number of kits
      POST
  • Vendors
    • Get a list of Vendors
    • Retrieve Vendors matching the given ID
    • Update a Vendor
    • Delete a Vendor
    • Bulk Add/Update Vendors
    • Create a new Vendor
  • Content
  • Promotions
    • Get a list of Promotions
    • Retrieve the Promotion matching the given ID
    • Get a list of Deals linked to the given Promotion
    • Retrieve the Deal matching the given ID under the given Promotion
    • Update the Deal's details, and optionally its status. Card and banner appearance stays inherited from the Promotion
    • Bulk Add/Update fixed price Deals under the given Promotion
    • Set the Deal's fixed price reward, with a price per product
    • Add products to the Deal's fixed price reward pool
    • Set the Deal's warehouses, price zones, customers and delivery dates in one call
  • Imports
  • Product Skus
    • Retrieve Fields matching the given ID
    • Retrieve Product Skus matching the given ID
    • Delete a Product Sku
    • Bulk Add/Update Product Skus across multiple Products
  • Pricing
    • Retrieve Pricing for a product that starts on a given date
    • Bulk Add/Update Pricing across multiple products
  • PriceZones
    • Retrieve PriceZone by ID
  • Product Highlights
    • Get a list of product highlights
    • Add products to the product highlight with a name, creating it if there is none
    • Add products to a product highlight
  • Product Options
  • Schemas
    • Schemas
      • Export
      • ExportParameter
      • PriceAssociatedProductSku
      • PriceList
      • Pricing
    • BulkFailMessage
    • AddressApiInput
    • DealAvailability
    • BulkSkippedProduct
    • SelectionItem
    • ProductOption
    • Customer
    • Address
    • Country
    • State
    • Distributor
    • FreeStock
    • OrderBatch
    • OrderLine
    • Person
    • PersonType
    • PricingMutation
    • ProductSku
    • Vendor
    • Warehouse
    • WarehouseUnderDistributor
    • BulkUpdateResult
    • Deal
    • DealBulkItemApiInput
    • DealUpdateApiInput
    • FIELD_TYPE
    • PERMISSION
    • PriceListMutation
    • ProductSkuApiInput
    • SELECTION_TYPE
    • DealAvailabilityApiInput
    • BulkSuccessItem
    • DealBulkApiInput
    • CompleteOrder
    • DealDateRange
    • CompleteOrderApiInput
    • DealDeliveryDateRangeApiInput
    • CompleteOrderBulkApiInput
    • DealPagedResults
    • CompleteOrderQuantityApiInput
    • DealProductPrice
    • CompleteOrderWithIdApiInput
    • DealProductPriceApiInput
    • DealProductsApiInput
    • DealReward
    • CustomerApiInput
    • CustomerAssociation
    • ENTITY_STATUS
    • CustomerAssociationApiInput
    • EntityAssociationResult
    • CustomerBulkApiInput
    • FIELD_COMPONENT
    • CustomerOrdering
    • CustomerOrderingApiInput
    • CustomerRule
    • Field
    • CustomerRuleApiInput
    • FieldComponent
    • CustomersConnection
    • KitComponent
    • PagedResults
    • DistributorPagedResults
    • PriceZone
    • ENTITY_STATUS_WITH_TEST
    • PricingCrossProductBulkApiInput
    • Email
    • ProductKitComponentApiInput
    • Error
    • ProductKitComponentBulkApiInput
    • ProductKitComponentCrossProductBulkApiInput
    • ProductSkuCrossProductBulkApiInput
    • Promotion
    • PromotionPagedResults
    • REWARD_APPLY
    • RolePermission
    • ORDER_STATUS
    • Section
    • OrderBatchStatusApiInput
    • Selection
    • OrderBatchStatusBulkApiInput
    • VISIBILITY
    • OrdersConnection
    • PRODUCT_SKU_STATUS_RAW
    • PersonApiInput
    • PersonBulkApiInput
    • PersonRule
    • PersonRuleApiInput
    • PersonTypeAssociation
    • PersonTypeAssociationApiInput
    • PersonsConnection
    • Phone
    • PriceAssociatedProductSkuMutation
    • PriceZonePagedResults
    • PricingBulkApiInput
    • PricingPagedResults
    • Product
    • ProductApiInput
    • ProductAssociation
    • ProductAssociationApiInput
    • ProductBulkApiInput
    • ProductHighlight
    • ProductHighlightByNameApiInput
    • ProductHighlightByNameResult
    • ProductHighlightPagedResults
    • ProductHighlightProductsApiInput
    • ProductOptionApiInput
    • ProductPagedResults
    • ProductRule
    • ProductRuleApiInput
    • ProductSkuBulkApiInput
    • SelectionPagedResults
    • VALIDATION_STATUS
    • ValidationProblemDetails
    • VendorApiInput
    • VendorBulkApiInput
    • VendorBulkItemApiInput
    • VendorPagedResults
    • WarehouseApiInput
    • WarehouseBulkApiInput
    • WarehouseBulkDistributorApiInput
    • WarehouseBulkItemApiInput
    • WarehousePagedResults
    • WarehouseSkuId
  1. Products

Get a list of Product Skus

GET
/v1/products/{id}/skus/list
Lists the product's SKUs as an array; the list is not paged. status ACTIVE, the default, lists every SKU that is not INACTIVE, IN_CATALOG ones included; INACTIVE lists the SKUs whose status is INACTIVE, such as one the DELETE route deactivated. name filters on SKUs whose name contains it, ignoring case, and an unknown product id answers an empty list.

Request

Path Params

Query Params

Responses

🟢200OK
application/json
OK
Bodyapplication/json

🟠400Bad Request
🟠401Record Not Found
🟠404
🟠429
🔴500
Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://marketplacerest.perenso.net/v1/products//skus/list?status=&name='
Response Response Example
200 - Success Example
{
    "id": "SKU-24-330",
    "name": "Sparkling Water 24 x 330ml",
    "productId": "PROD-1042",
    "status": "ACTIVE",
    "displayOrder": 0,
    "mpc": "AC-SW-24330",
    "upc": "9300000123456",
    "size": 330,
    "sizeUnit": "ml",
    "pack": 24,
    "packUnit": "CTN",
    "weightUnit": "kg",
    "grossWeight": 8.6,
    "netWeight": 7.92,
    "isDefaultName": false,
    "isSoldByWeight": false,
    "options": [
        {
            "id": "330ML",
            "name": "330ml"
        }
    ],
    "warehouseSkuIds": [
        {
            "warehouseId": "WH-SYD",
            "skuId": "SYD-24330"
        }
    ],
    "customFields": {
        "NOTES": {
            "type": "TEXT",
            "value": "Glass bottles"
        }
    }
}
Modified at 2026-11-17 17:43:44
Previous
Delete a Product
Next
Create a new Product Sku
Built with