Skip to main content

Catalog

Manages product catalogs, including adding, updating, and deleting products, as well as categorizing them.

Brand

A brand represents a specific brand or manufacturer associated with a product. Brands help customers identify and differentiate products based on their manufacturer or designer. Each brand typically has a unique identifier and a name. For example, a clothing platform might have brands such as "Nike," "Adidas," "Gucci," and "Zara." Our Brand APIs facilitate access to brand-related data, offering functionalities such as retrieving list of available brands and obtaining detailed information about a specific brand using its unique slug.

Operations
GET
/service/application/catalog/v1.0/brands/
# List brands
GET
/service/application/catalog/v1.0/brands/{slug}/
# Get a brand
GET

List brands

Retrieves a list of all the availabe brands. Filtering can be applied on department.
Parameters
department
string
Optional
The name of the department. Use this parameter to filter products by a particular department. See the list of available departments below. Also, you can get available departments from the endpoint /service/application/catalog/v1.0/departments/
Enum
pageNo
integer
Optional
The page number to navigate through the given set of results.
Default Value : 1
pageSize
integer
Optional
The number of items to retrieve in each page.
Default Value : 12
Response
200
4XX
Success. Returns a paginated list of brands. Check the example shown below or refer `BrandListingResponse` for more details.
BrandListingResponse
items
array of object (BrandItem)
Optional
Array of BrandItem
page
object (Page)
Page
Examples
Parameters
department:
"value"
pageNo:
0
pageSize:
0
Was this section helpful?
GET
/service/application/catalog/v1.0/brands/
Loading...
Response
Loading...
GET

Get a brand

Retrieve metadata of a brand such as name, information, logo, banner, etc.
Parameters
slug
string
A short, human-readable, URL-friendly identifier of a brand. You can get slug value from the endpoint /service/application/catalog/v1.0/brands/.
Response
200
4XX
Success. Returns a metadata object. Check the example shown below or refer `BrandDetailResponse` for more details.
BrandDetailResponse
logo
object (Media)
Optional
Media
uid
integer
Optional
description
string
Optional
banners
object (ImageUrls)
Optional
ImageUrls
_custom_json
object
Optional
name
string
Optional
Examples
Parameters
slug:
"value"
Was this section helpful?
GET
/service/application/catalog/v1.0/brands/{slug}/
Loading...
Response
Loading...

Category

Categories are hierarchical structure that enables a systematic organization of products for better discoverability of products on storefront. Categories are structured into three levels: L1, L2, and L3, with L1 representing the top-level category, followed by L2 and L3. For example - Clothing(L1) >> Shirts(L2) >> Formal Shirts(L3) A single L1 category can encompass multiple L2 categories underneath it, and similarly, an L2 category can contain multiple L3 categories within it. Category is a sales-channel specific configuration. While categories are common across all companies, sales channel can configure L3 category names tailored to their unique requirements.

Operations
GET
/service/application/catalog/v1.0/categories/
# List product categories
GET
/service/application/catalog/v1.0/categories/{slug}/
# Get category by slug
GET

List product categories

Retrieves a list of all available product categories. Also user can filter the categories by department.
Parameters
department
string
Optional
The name of the department. Use this parameter to filter products by a particular department. See the list of available departments below. Also, you can get available departments from the endpoint /service/application/catalog/v1.0/departments/
Enum
Response
200
4XX
Success. Returns a list of categories. Check the example shown below or refer `CategoryListingResponse` for more details.
CategoryListingResponse
data
array of object (DepartmentCategoryTree)
Optional
Array of DepartmentCategoryTree
departments
array of object (DepartmentIdentifier)
Optional
Array of DepartmentIdentifier
Examples
Parameters
department:
"value"
Was this section helpful?
GET
/service/application/catalog/v1.0/categories/
Loading...
Response
Loading...
GET

Get category by slug

Retrieve detailed information about a specific product category using its slug and Retrieve metadata of a category such as name, information, logo, banner, etc.
Parameters
slug
string
A short, human-readable, URL-friendly identifier of a brand. You can get slug value from the endpoint /service/application/catalog/v1.0/brands/.
Response
200
4XX
Success. Returns metadata of a category. Check the example shown below or refer `CategoryMetaResponse` for more details.
CategoryMetaResponse
logo
object (Media)
Optional
Media
uid
integer
Optional
banners
object (ImageUrls)
Optional
ImageUrls
_custom_json
object
Optional
name
string
Optional
Examples
Parameters
slug:
"value"
Was this section helpful?
GET
/service/application/catalog/v1.0/categories/{slug}/
Loading...
Response
Loading...

Collection

A collection is a grouping of products that sellers can create to make their stores easier to browse. For example, a seller might create a collection for a specific type of product by latest fashion trend or season, such as Summer collection or streetwear collection. Collections can be rule based on conditions like specific brand, category, etc. or a custom collection which can be comprised of handpicked products. Retrieve a list of collections, access items within a specific collection using its slug or unique identifier, and obtain detailed information about a specific collection, including its title, description, and associated items. This resource streamlines the management of curated sets of products, services, or other items., retrieve, update, and delete collections. Add and retrieve items within collections for organized content management.

Operations
GET
/service/application/catalog/v1.0/collections/
# List collections
GET
/service/application/catalog/v1.0/collections/{slug}/items/
# Lists items of collection
GET
/service/application/catalog/v1.0/collections/{slug}/
# Get a collection
GET

List collections

Retrieve a list of curated product collections with filtering options based on tags and collection names.
Parameters
pageNo
integer
Optional
The page number to navigate through the given set of results.
Default Value : 1
pageSize
integer
Optional
The number of items to retrieve in each page.
Default Value : 12
tag
array of string
Optional
List of tags to filter collections
Minimum Items : 1
q
string
Optional
Name of the collection to filter collection
Response
200
4XX
Success. Returns a list of collections. Check the example shown below or refer `GetCollectionListingResponse` for more details.
GetCollectionListingResponse
items
array of object (GetCollectionDetailNest)
Optional
Array of GetCollectionDetailNest
filters
object (CollectionListingFilter)
Optional
CollectionListingFilter
page
object (Page)
Page
Examples
Parameters
pageNo:
0
pageSize:
0
tag:
"lorem","ipsum"
q:
"value"
Was this section helpful?
GET
/service/application/catalog/v1.0/collections/
Loading...
Response
Loading...
GET

Lists items of collection

Fetch items within a particular collection identified by its slug.
Parameters
slug
string
A short, human-readable, URL-friendly identifier of a collection. You can get slug value from the endpoint /service/application/catalog/v1.0/collections/.
f
string
Optional
The search filter parameters. Filter parameters will be passed in f parameter as shown in the example below. Double Pipe (||) denotes the OR condition, whereas Triple-colon (:::) indicates a new filter paramater applied as an AND condition.
q
string
Optional
The search query for entering partial or full name of product, brand, category, or collection.
filters
boolean
Optional
This is a boolean value, True for fetching all filter parameters and False for disabling the filter parameters.
Default Value : true
sortOn
string
Optional
The order in which the list of products should be sorted, e.g. popularity, price, latest and discount, in either ascending or descending order. See the supported values below.
Enum
pageId
string
Optional
Page ID to retrieve next set of results.
Default Value : 1
pageSize
integer
Optional
The number of items to retrieve in each page.
Default Value : 12
pageNo
integer
Optional
Page Number to retrieve next set of results.
Default Value : 1
pageType
string
Optional
Page Type to retrieve set of results can be cursor or number.
Response
200
4XX
Success. Returns a list items in a given collection. Check the example shown below or refer `ProductListingResponse` for more details.
ProductListingResponse
items
array of object (ProductListingDetail)
Optional
Array of ProductListingDetail
filters
array of object (ProductFilters)
Optional
Array of ProductFilters
page
object (Page)
Page
sort_on
array of object (ProductSortOn)
Optional
Array of ProductSortOn
Examples
Parameters
slug:
"value"
f:
"value"
q:
"value"
filters:
false
sortOn:
"value"
pageId:
"value"
pageSize:
0
pageNo:
0
pageType:
"value"
Was this section helpful?
GET
/service/application/catalog/v1.0/collections/{slug}/items/
Loading...
Response
Loading...
GET

Get a collection

Retrieve detailed information about a specific collection using its slug.
Parameters
slug
string
A short, human-readable, URL-friendly identifier of a collection. You can get slug value from the endpoint /service/application/catalog/v1.0/collections/.
Response
200
4XX
Success. Returns a Collection object. Check the example shown below or refer `CollectionDetailResponse` for more details.
CollectionDetailResponse
is_active
boolean
Optional
sort_on
string
Optional
meta
object
Optional
banners
object (ImageUrls)
Optional
ImageUrls
cron
object
Optional
_schedule
object
Optional
query
array of object (CollectionQuery)
Optional
Array of CollectionQuery
description
string
Optional
type
string
Optional
_custom_json
object
Optional
name
string
Optional
allow_sort
boolean
Optional
visible_facets_keys
array of string
Optional
badge
object
Optional
slug
string
Optional
allow_facets
boolean
Optional
logo
object (Media)
Optional
Media
priority
integer
Optional
tag
array of string
Optional
app_id
string
Optional
Examples
Parameters
slug:
"value"
Was this section helpful?
GET
/service/application/catalog/v1.0/collections/{slug}/
Loading...
Response
Loading...

Department

A department categorizes products into different sections or categories based on their type or purpose. Departments help organize products in a logical manner, making it easier for customers to navigate the product catalog. Each department typically has a unique identifier and a name. For example, a clothing ecommerce platform might have departments such as "Men's Clothing," "Women's Clothing," "Accessories," and "Footwear." You can retrieve a list of all departments associated with available products, facilitating easy navigation and organization of products based on departmental categorization. Additionally, the APIs allow you to list all products associated with a specific brand, collection, or category in a random order, enhancing user engagement and discovery within your application

Operations
GET
/service/application/catalog/v1.0/departments/
# List departments
GET

List departments

Retrieve a list of all departments associated with available products.
Parameters
No Parameters
Response
200
4XX
List of Departments. See example below or refer `DepartmentResponse` for details.
DepartmentResponse
items
array of object (Department)
Optional
Array of Department
Examples
Parameters
Parameters are not required.
Was this section helpful?
GET
/service/application/catalog/v1.0/departments/
Loading...
Response
Loading...

Follow and Unfollow

Customers have the ability to follow or unfollow specific products based on their preferences, allowing them to curate a list of favorites. This feature enables users to manage their preferences and interactions with different content or entities. By retrieving a list of products or brands they are following, customers can easily keep track of their interests. They can remove items, brands, or products from their followed list using the collection ID, and add new ones using the same ID. Additionally, customers can find out how many other users are following a specific item and get the IDs of all the items they are currently following, whether they are products, brands, or collections.

Operations
GET
/service/application/catalog/v1.0/follow/{collection_type}/
# List followed products, brands
DEL
/service/application/catalog/v1.0/follow/{collection_type}/{collection_id}/
# Delete item, brand, product
POST
/service/application/catalog/v1.0/follow/{collection_type}/{collection_id}/
# Create item, brand, product
GET
/service/application/catalog/v1.0/follow/{collection_type}/{collection_id}/count/
# Get follower count
GET
/service/application/catalog/v1.0/follow/ids/
# List Ids of followed item, brand, product
GET

List followed products, brands

Retrieve a list of products or brands the user is following.
Parameters
collectionType
string
Type of collection followed, i.e. products, brands, or collections.
pageId
string
Optional
Page ID to retrieve next set of results.
Default Value : 1
pageSize
integer
Optional
Page ID to retrieve next set of results.
Default Value : 12
Response
200
4XX
Success. Returns a Followed resource object. Check the example shown below or refer `GetFollowListingResponse` for more details.
GetFollowListingResponse
items
array of object (ProductListingDetail)
Array of ProductListingDetail
page
object (Page)
Page
Examples
Parameters
collectionType:
"value"
pageId:
"value"
pageSize:
0
Was this section helpful?
GET
/service/application/catalog/v1.0/follow/{collection_type}/
Loading...
Response
Loading...
DEL

Delete item, brand, product

Removes a followed item, brand, or product using its collection ID.
Parameters
collectionType
string
Type of collection followed, i.e. products, brands, or collections.
collectionId
string
The ID of the collection type.
Response
200
4XX
Success. Returns a response object. Check the example shown below or refer `FollowPostResponse` for more details.
FollowPostResponse
message
string
id
string
Examples
Parameters
collectionType:
"value"
collectionId:
"value"
Was this section helpful?
DEL
/service/application/catalog/v1.0/follow/{collection_type}/{collection_id}/
Loading...
Response
Loading...
POST

Create item, brand, product

Adds a product, brand, or item to the user's followed list by collection Id
Parameters
collectionType
string
Type of collection followed, i.e. products, brands, or collections.
collectionId
string
The ID of the collection type.
Response
200
4XX
Success. Returns a response object. Check the example shown below or refer `FollowPostResponse` for more details.
FollowPostResponse
message
string
id
string
Examples
Parameters
collectionType:
"value"
collectionId:
"value"
Was this section helpful?
POST
/service/application/catalog/v1.0/follow/{collection_type}/{collection_id}/
Loading...
Response
Loading...
GET

Get follower count

Retrieves the total number of followers for a specific item by its Id.
Parameters
collectionType
string
Type of collection, i.e. products, brands, or collections.
collectionId
string
The ID of the collection type.
Response
200
4XX
Success. Returns the number of followers for a given collection type. Check the example shown below or refer `FollowerCountResponse` for more details.
FollowerCountResponse
count
integer
Optional
Examples
Parameters
collectionType:
"value"
collectionId:
"value"
Was this section helpful?
GET
/service/application/catalog/v1.0/follow/{collection_type}/{collection_id}/count/
Loading...
Response
Loading...
GET

List Ids of followed item, brand, product

Retrieves the IDs of all items the user is currently following like Products, Brands and Collections
Parameters
collectionType
string
Optional
Type of collection, i.e. products, brands, collections.
Response
200
4XX
Success. Returns the IDs of all the Products, Brands and Collections which were followed. Check the example shown below or refer `FollowIdsResponse` for more details.
FollowIdsResponse
data
object (FollowIdsData)
Optional
FollowIdsData
Examples
Parameters
collectionType:
"value"
Was this section helpful?
GET
/service/application/catalog/v1.0/follow/ids/
Loading...
Response
Loading...

Product

A Product is an individual item available for sale. It includes details like the product's name, description, price, images, and variants (such as size or colour). This resource is crucial for managing the catalogue of items that customers can browse, search for, and purchase. Additionally, you can retrieve information about each product, including availability, sizes with quantities, dimensions, stock status, pricing details (marked, effective, selling), and minimum order quantity (MOQ). The APIs further support accessing products within the same category as a specified product, all available variants of a product, current stock status using unique identifiers like SKU, ALU, and EAN, as well as estimated future stock levels. Moreover, you can retrieve a comprehensive list of all products in the catalogue at the application level, with robust filtering options based on product attributes like name, brand, department, category, and collection, along with versatile sorting options based on factors like price, ratings, and discounts. The Product resource at the application level also facilitates operations such as retrieving product bundles, obtaining the price of specific product sizes across selling locations near a given PIN code, and retrieving a list of sellers offering a specific product in a specific size. With these functionalities, the 'Product' resource empowers you to efficiently manage and analyze your product catalogue holistically across your entire application, streamline operations, and enhance customer experiences

Operations
GET
/service/application/catalog/v1.0/products/{slug}/
# Get a product
GET
/service/application/catalog/v1.0/products/{slug}/sizes/
# List sizes
GET
/service/application/catalog/v1.0/products/compare/
# List products for comparison
GET
/service/application/catalog/v1.0/products/{slug}/similar/compare/
# List similar products
GET
/service/application/catalog/v1.0/products/{slug}/similar/compared-frequently/
# List frequent products
GET
/service/application/catalog/v1.0/products/{slug}/variants/
# List product variants
GET
/service/application/catalog/v1.0/products/stock-status/
# Get product stocks
GET
/service/application/catalog/v1.0/products/stock-status/poll/
# List future stock
GET
/service/application/catalog/v1.0/products/
# List products
GET
/service/application/catalog/v1.0/home/listing/
# List homepage-featured products
GET
/service/application/catalog/v1.0/product-grouping/
# List product bundles
GET
/service/application/catalog/v3.0/products/{slug}/sizes/{size}/price/
# Get product price
GET
/service/application/catalog/v3.0/products/{slug}/sizes/{size}/sellers/
# List sellers
GET

Get a product

Fetches properties related to Product such as price, attributes, HSN code, SKU code, etc.
Parameters
slug
string
A short, human-readable, URL-friendly identifier of a product. You can get slug value from the endpoint /service/application/catalog/v1.0/products/
Response
200
4XX
Success. Returns a Product object. Check the example shown below or refer `ProductDetail` for more details.
ProductDetail
uid
integer
Optional
custom_order
object (ProductDetailCustomOrder)
Optional
ProductDetailCustomOrder
category_map
object (ProductCategoryMap)
Optional
ProductCategoryMap
net_quantity
object (NetQuantity)
Optional
NetQuantity
rating_count
integer
Optional
_custom_meta
array of object (CustomMetaFields)
Optional
Array of CustomMetaFields
similars
array of string
Optional
tags
array of string
Optional
seo
object (ApplicationItemSEO)
Optional
ApplicationItemSEO
image_nature
string
Optional
has_variant
boolean
Optional
item_type
string
Optional
description
string
Optional
grouped_attributes
array of object (ProductDetailGroupedAttribute)
Optional
Array of ProductDetailGroupedAttribute
medias
array of object (Media)
Optional
Array of Media
color
string
Optional
type
string
Optional
product_online_date
string
| date-time
Optional
_custom_json
object
Optional
item_code
string
Optional
name
string
Optional
moq
object (ApplicationItemMOQ)
Optional
ApplicationItemMOQ
short_description
string
Optional
categories
array of object (ProductBrand)
Optional
Array of ProductBrand
attributes
object
Optional
discount
string
Optional
tryouts
array of string
Optional
slug
string
action
object (ProductListingAction)
Optional
ProductListingAction
rating
number
Optional
is_dependent
boolean
Optional
product_group_tag
array of string
Optional
highlights
array of string
Optional
price
object (ProductListingPrice)
Optional
ProductListingPrice
brand
object (ProductBrand)
Optional
ProductBrand
department
object (ProductDepartment)
Optional
ProductDepartment
teaser_tag
string
Optional
Examples
Parameters
slug:
"value"
Was this section helpful?
GET
/service/application/catalog/v1.0/products/{slug}/
Loading...
Response
Loading...
GET

List sizes

Provides detailed information about a product, including its availability (sellable), available sizes with quantities, dimensions, weight, availability status, price details (marked, effective, selling), minimum order quantity (MOQ).
Parameters
slug
string
A short, human-readable, URL-friendly identifier of a product. You can get slug value from the endpoint /service/application/catalog/v1.0/products/
storeId
integer
Optional
The ID of the store that is selling the product, e.g. 1,2,3.
Response
200
4XX
Success. Returns a ProductSize object. Check the example shown below or refer `ProductSizes` for more details.
ProductSizes
sizes
array of object (ProductSize)
Optional
Array of ProductSize
price
object (ProductSizesPrice)
Optional
ProductSizesPrice
size_chart
object (SizeChart)
Optional
SizeChart
sellable
boolean
Optional
multi_size
boolean
Optional
discount
string
Optional
stores
object (ProductSizeStores)
Optional
ProductSizeStores
discount_meta
object (DiscountMeta)
Optional
DiscountMeta
Examples
Parameters
slug:
"value"
storeId:
0
Was this section helpful?
GET
/service/application/catalog/v1.0/products/{slug}/sizes/
Loading...
Response
Loading...
GET

List products for comparison

Retrives all the products that have same category.
Parameters
slug
array of string
A short, human-readable, URL-friendly identifier of a product. You can get slug value from the endpoint /service/application/catalog/v1.0/products/.
Minimum Items : 1
Response
200
4XX
Success. Returns an array of objects containing the attributes for comparision. Check the example shown below or refer `ProductsComparisonResponse` for more details.
ProductsComparisonResponse
items
array of object (ProductDetail)
Optional
Array of ProductDetail
attributes_metadata
array of object (AttributeMetadata)
Optional
Array of AttributeMetadata
Examples
Parameters
slug:
"lorem","ipsum"
Was this section helpful?
GET
/service/application/catalog/v1.0/products/compare/
Loading...
Response
Loading...
GET

List similar products

Retrives all products within the same category as the one specified by the provided slug.
Parameters
slug
string
A short, human-readable, URL-friendly identifier of a product. You can get slug value from the endpoint /service/application/catalog/v1.0/products/
Response
200
4XX
Success. Returns an array of objects containing the attributes for comparision. Check the example shown below or refer `ProductCompareResponse` for more details.
ProductCompareResponse
title
string
Optional
items
array of object (ProductDetail)
Optional
Array of ProductDetail
attributes_metadata
array of object (AttributeMetadata)
Optional
Array of AttributeMetadata
subtitle
string
Optional
Examples
Parameters
slug:
"value"
Was this section helpful?
GET
/service/application/catalog/v1.0/products/{slug}/similar/compare/
Loading...
Response
Loading...
GET

List frequent products

Retrieve products that are often compared to the product specified by its slug.
Parameters
slug
string
A short, human-readable, URL-friendly identifier of a product. You can get slug value from the endpoint /service/application/catalog/v1.0/products/
Response
200
4XX
Success. Returns an array of objects containing the attributes for comparision. Check the example shown below or refer `ProductFrequentlyComparedSimilarResponse` for more details.
ProductFrequentlyComparedSimilarResponse
similars
object (ProductCompareResponse)
Optional
ProductCompareResponse
Examples
Parameters
slug:
"value"
Was this section helpful?
GET
/service/application/catalog/v1.0/products/{slug}/similar/compared-frequently/
Loading...
Response
Loading...
GET

List product variants

Retrieves all available variants of a specific product identified by its slug.
Parameters
slug
string
A short, human-readable, URL-friendly identifier of a product. You can get slug value from the endpoint /service/application/catalog/v1.0/products/
Response
200
4XX
Success. Returns all variants of a product. Check the example shown below or refer `ProductVariantsResponse` for more details. For `display_type:image`, `color` key will be present otherwise `value` key will be shown.
ProductVariantsResponse
variants
array of object (ProductVariantResponse)
Optional
Array of ProductVariantResponse
Examples
Parameters
slug:
"value"
Was this section helpful?
GET
/service/application/catalog/v1.0/products/{slug}/variants/
Loading...
Response
Loading...
GET

Get product stocks

Retrieves the current stock status for products identified by their IDs. such as SKU,ALU,EAN etc
Parameters
itemId
string
Optional
The Item ID of the product (Max. 50 allowed)
alu
string
Optional
ALU of the product (limited upto 50 ALU identifier in a single request)
skuCode
string
Optional
Stock-keeping Unit of the product (limited upto 50 SKU Code in a single request)
ean
string
Optional
European Article Number of the product (limited upto 50 EAN identifier in a single request)
upc
string
Optional
Universal Product Code of the product (limited upto 50 UPC identifier in a single request)
Response
200
4XX
Success. Returns the status of the product stock.Check the example shown below or refer `ProductStockStatusResponse` for more details.
ProductStockStatusResponse
items
array of object (ProductStockStatusItem)
Optional
Array of ProductStockStatusItem
Examples
Parameters
itemId:
"value"
alu:
"value"
skuCode:
"value"
ean:
"value"
upc:
"value"
Was this section helpful?
GET
/service/application/catalog/v1.0/products/stock-status/
Loading...
Response
Loading...
GET

List future stock

Retrives the available stock levels for all products associated with a particular sales channel at a specified future time.
Parameters
timestamp
string
Timestamp in UTC format (2020-07-23T10:27:50Z)
pageSize
integer
Optional
The number of items to retrieve in each page.
Default Value : 12
pageId
string
Optional
Page ID to retrieve next set of results.
Response
200
4XX
Success. Returns the status of the product stock.Check the example shown below or refer `ProductStockPolling` for more details.
ProductStockPolling
items
array of object (ProductStockStatusItem)
Optional
Array of ProductStockStatusItem
page
object (Page)
Page
Examples
Parameters
timestamp:
"value"
pageSize:
0
pageId:
"value"
Was this section helpful?
GET
/service/application/catalog/v1.0/products/stock-status/poll/
Loading...
Response
Loading...
GET

List products

Retrieves a list of all products available in the catalog. It supports filtering based on product name, brand, department, category, collection, and more, while also offering sorting options based on factors like price, ratings, discounts, and other relevant criteria.
Parameters
q
string
Optional
The search query for entering partial or full name of product, brand, category, or collection.
f
string
Optional
The search filter parameters. Filter parameters will be passed in f parameter as shown in the example below. Double Pipe (||) denotes the OR condition, whereas Triple-colon (:::) indicates a new filter paramater applied as an AND condition.
filters
boolean
Optional
This is a boolean value, True for fetching all filter parameters and False for disabling the filter parameters.
Default Value : true
sortOn
string
Optional
The order in which the list of products should be sorted, e.g. popularity, price, latest and discount, in either ascending or descending order. See the supported values below.
Enum
pageId
string
Optional
Page ID to retrieve next set of results.
pageSize
integer
Optional
The number of items to retrieve in each page.
Default Value : 12
pageNo
integer
Optional
The page number to navigate through the given set of results.
Default Value : 1
pageType
string
Optional
Available pagination types are cursor or number.
Default Value : cursor
Response
200
4XX
Success. Returns a paginated list of products..Check the example shown below or refer `ProductListingResponse` for more details.
ProductListingResponse
items
array of object (ProductListingDetail)
Optional
Array of ProductListingDetail
filters
array of object (ProductFilters)
Optional
Array of ProductFilters
page
object (Page)
Page
sort_on
array of object (ProductSortOn)
Optional
Array of ProductSortOn
Examples
Parameters
q:
"value"
f:
"value"
filters:
false
sortOn:
"value"
pageId:
"value"
pageSize:
0
pageNo:
0
pageType:
"value"
Was this section helpful?
GET
/service/application/catalog/v1.0/products/
Loading...
Response
Loading...
GET

List homepage-featured products

List all the products associated with a brand, collection or category in a random order.
Parameters
sortOn
string
Optional
The order in which the list of products should be sorted, e.g. popularity, price, latest and discount, in either ascending or descending order.
pageId
string
Optional
Page ID to retrieve next set of results.
Default Value : 1
pageSize
integer
Optional
The number of items to retrieve in each page.
Default Value : 12
Response
200
4XX
Success. Returns a paginated list of products. Check the example shown below or refer `HomeListingResponse` for more details.
HomeListingResponse
items
array of object (ProductListingDetail)
Optional
Array of ProductListingDetail
page
object (Page)
Page
message
string
Optional
Examples
Parameters
sortOn:
"value"
pageId:
"value"
pageSize:
0
Was this section helpful?
GET
/service/application/catalog/v1.0/home/listing/
Loading...
Response
Loading...
GET

List product bundles

Retrieve products bundles to the one specified by its slug.
Parameters
slug
string
Optional
Product slug for which bundles need to be fetched.
id
string
Optional
Product uid
Response
200
4XX
Success. Returns a group of products bundle.
ProductBundle
items
array of object (ProductGroupingModel)
Optional
Array of ProductGroupingModel
Examples
Parameters
slug:
"value"
id:
"value"
Was this section helpful?
GET
/service/application/catalog/v1.0/product-grouping/
Loading...
Response
Loading...
GET

Get product price

Retrieve the price of a product size at all the selling locations near to a PIN Code.
Parameters
slug
string
A short, human-readable, URL-friendly identifier of a product. You can get slug value from the endpoint /service/application/catalog/v1.0/products/
size
string
A string indicating the size of the product, e.g. S, M, XL. You can get slug value from the endpoint /service/application/catalog/v1.0/products/sizes
storeId
integer
Optional
The ID of the store that is selling the product, e.g. 1,2,3.
moq
integer
Optional
An Integer indication the Minimum Order Quantity of a product, e.g. 100.
Response
200
4XX
Success. Returns a ProductSizePriceV3 object. Check the example shown below or refer `ProductSizePriceResponseV3` for more details.
ProductSizePriceResponseV3
store
object (StoreV3)
Optional
StoreV3
article_assignment
object (ArticleAssignmentV3)
Optional
ArticleAssignmentV3
is_cod
boolean
Optional
strategy_wise_listing
array of object (StrategyWiseListingSchemaV3)
Optional
Array of StrategyWiseListingSchemaV3
quantity
integer
Optional
item_type
string
Optional
grouped_attributes
array of object (SellerGroupAttributes)
Optional
Array of SellerGroupAttributes
return_config
object (ReturnConfigSchemaV3)
Optional
ReturnConfigSchemaV3
article_id
string
Optional
is_gift
boolean
Optional
set
object (ProductSetV3)
Optional
ProductSetV3
seller_count
integer
Optional
price_per_piece
object (ProductStockPriceV3)
Optional
ProductStockPriceV3
discount_meta
object (DiscountMeta)
Optional
DiscountMeta
discount
string
Optional
long_lat
array of number
Optional
special_badge
string
Optional
price
object (ProductStockPriceV3)
Optional
ProductStockPriceV3
price_per_unit
object (ProductStockUnitPriceV3)
Optional
ProductStockUnitPriceV3
pincode
integer
Optional
marketplace_attributes
array of object (MarketPlaceSttributesSchemaV3)
Optional
Array of MarketPlaceSttributesSchemaV3
seller
object (SellerV3)
Optional
SellerV3
delivery_promise
object (PromiseSchema)
Optional
PromiseSchema
Examples
Parameters
slug:
"value"
size:
"value"
storeId:
0
moq:
0
Was this section helpful?
GET
/service/application/catalog/v3.0/products/{slug}/sizes/{size}/price/
Loading...
Response
Loading...
GET

List sellers

Retrieve a list of all sellers offering a specific product identified by its slug and size
Parameters
slug
string
A short, human-readable, URL-friendly identifier of a product. You can get slug value from the endpoint /service/application/catalog/v1.0/products/
size
string
A string indicating the size of the product, e.g. S, M, XL. You can get slug value from the endpoint /service/application/catalog/v1.0/products/sizes
strategy
string
Optional
Sort stores on the basis of strategy. eg, fast-delivery, low-price, optimal.
pageNo
integer
Optional
The page number to navigate through the given set of results.
Default Value : 1
pageSize
integer
Optional
The number of items to retrieve in each page.
Default Value : 12
Response
200
4XX
Success. Returns a ProductSizeSellerV3 object. Check the example shown below or refer `ProductSizeSellersResponseV3` for more details.
ProductSizeSellersResponseV3
items
array of object (ProductSizePriceResponseV3)
Optional
Array of ProductSizePriceResponseV3
page
object (Page)
Page
sort_on
array of object (ProductSizeSellerFilterSchemaV3)
Optional
Array of ProductSizeSellerFilterSchemaV3
Examples
Parameters
slug:
"value"
size:
"value"
strategy:
"value"
pageNo:
0
pageSize:
0
Was this section helpful?
GET
/service/application/catalog/v3.0/products/{slug}/sizes/{size}/sellers/
Loading...
Response
Loading...

Search Autocomplete Suggestions

Search autocomplete suggestions are the results derived by user search queries giving suggestions according to what the customer has searched. Retrieve search results for products, brands, or categories based on user queries. Searches can be performed using partial or full text for names, enabling comprehensive and flexible search capabilities.

Operations
GET
/service/application/catalog/v1.0/auto-complete/
# List product, brand, category
GET

List product, brand, category

Retrieve products, brands, or categories based on a search query, which can be a partial or full name match.
Parameters
q
string
The search query for entering partial or full name of a product, brand or category. For example, if the given search query `q` is _ski_, the relevant search suggestions could be _skirt_, _ski shoes_, __skin cream_ etc.
Response
200
4XX
Success. Returns a list autocomplete suggestions for the search query `q`. Check the example shown below or refer `AutoCompleteResponse` for more details.
AutoCompleteResponse
items
array of object (AutocompleteItem)
Optional
Array of AutocompleteItem
Examples
Parameters
q:
"value"
Was this section helpful?
GET
/service/application/catalog/v1.0/auto-complete/
Loading...
Response
Loading...

Selling Location

A selling location represents a geographical location where your stores, pop-up stores, headquarters, and warehouses exist. Find in-stock locations for products Additionally, the API retrieves detailed location information by ID, offering comprehensive store details for enhanced user convenience.

Operations
GET
/service/application/catalog/v1.0/locations/
# List available stores
GET
/service/application/catalog/v1.0/in-stock/locations/
# List stores with inventory
GET
/service/application/catalog/v1.0/locations/{location_id}/
# Get selling location
GET

List available stores

Retrieves a list of all stores associated with sales channel
Parameters
pageNo
integer
Optional
The page number to navigate through the given set of results.
Default Value : 1
pageSize
integer
Optional
Number of items to retrieve in each page.
Default Value : 12
q
string
Optional
Search a store by its name or store_code.
city
string
Optional
Search stores by the city in which they are situated.
range
integer
Optional
Use this to retrieve stores within a particular range in meters, e.g. 10000, to indicate a 10km range
Default Value : 20000
latitude
number
Optional
Latitude of the location from where one wants to retreive the nearest stores, e.g. 72.8691788
longitude
number
Optional
Longitude of the location from where one wants to retreive the nearest stores, e.g. 19.1174114
tags
string
Optional
Search stores based on tags.
Response
200
4XX
Success. Returns a list of selling locations. Check the example shown below or refer `StoreListingResponse` for more details.
StoreListingResponse
items
array of object (Store)
Array of Store
page
object (Page)
Page
Examples
Parameters
pageNo:
0
pageSize:
0
q:
"value"
city:
"value"
range:
0
latitude:
1.1
longitude:
1.1
tags:
"value"
Was this section helpful?
GET
/service/application/catalog/v1.0/locations/
Loading...
Response
Loading...
GET

List stores with inventory

Lists stores where specified products are currently in stock.
Parameters
pageNo
integer
Optional
The page number to navigate through the given set of results.
Default Value : 1
pageSize
integer
Optional
Number of items to retrieve in each page.
Default Value : 12
q
string
Optional
Search a store by its name or store_code.
city
string
Optional
Search stores by the city in which they are situated.
range
integer
Optional
Use this to retrieve stores within a particular range in meters, e.g. 10000, to indicate a 10km range
Default Value : 20000
latitude
number
Optional
Latitude of the location from where one wants to retreive the nearest stores, e.g. 72.8691788
longitude
number
Optional
Longitude of the location from where one wants to retreive the nearest stores, e.g. 19.1174114
Response
200
4XX
Success. Returns a list of selling locations. Check the example shown below or refer `StoreListingResponse` for more details.
ApplicationStoreListing
filters
array of object
Optional
items
array of object (AppStore)
Optional
Array of AppStore
page
object (Page)
Optional
Page
Examples
Parameters
pageNo:
0
pageSize:
0
q:
"value"
city:
"value"
range:
0
latitude:
1.1
longitude:
1.1
Was this section helpful?
GET
/service/application/catalog/v1.0/in-stock/locations/
Loading...
Response
Loading...
GET

Get selling location

This API retrieves comprehensive details about a store based on its location Id
Parameters
locationId
integer
Unique Location ID.
Response
200
4XX
Success. Returns a metadata object. Check the example shown below or refer `StoreDetails` for more details.
StoreDetails
uid
integer
Optional
departments
array of object (StoreDepartments)
Optional
Array of StoreDepartments
company
object (CompanyStore)
Optional
CompanyStore
manager
object (StoreManagerSerializer)
Optional
StoreManagerSerializer
store_code
string
Optional
timing
array of object (StoreTiming)
Optional
Array of StoreTiming
address
object (StoreAddressSerializer)
Optional
StoreAddressSerializer
_custom_json
object
Optional
name
string
Optional
contact_numbers
array of object (SellerPhoneNumber)
Optional
Array of SellerPhoneNumber
Examples
Parameters
locationId:
0
Was this section helpful?
GET
/service/application/catalog/v1.0/locations/{location_id}/
Loading...
Response
Loading...