GroceryApi
All URIs are relative to https://business.apis.kesk.app/v1
| Method | HTTP request | Description |
|---|---|---|
| addToGroceryStoreCart | POST /grocery/stores/{vendor_id}/{location_id}/cart/items | Add a product to the grocery store cart. |
| clearGroceryStoreCart | DELETE /grocery/stores/{vendor_id}/{location_id}/cart | Clear all items from the grocery store cart. |
| getGroceryProduct | GET /grocery/products/{id} | Get grocery product details |
| getGroceryStore | GET /grocery/stores/{id} | Get grocery store (location) details |
| getGroceryStoreCart | GET /grocery/stores/{vendor_id}/{location_id}/cart | Get cart for a specific grocery store location. |
| getGroceryStoreProductQuantityInCart | GET /grocery/stores/{vendor_id}/{location_id}/cart/product/{product_id}/quantity | Get quantity information for a product in the cart. |
| listGroceryCategories | GET /grocery/categories | List grocery categories |
| listGroceryProducts | GET /grocery/products | List grocery products |
| listGroceryStores | GET /grocery/stores | List grocery stores (locations) |
| listGrocerySubcategories | GET /grocery/categories/{category_id}/subcategories | List grocery subcategories |
| removeFromGroceryStoreCart | DELETE /grocery/stores/{vendor_id}/{location_id}/cart/items | Remove an item from the grocery store cart. |
| updateGroceryStoreCartItem | PUT /grocery/stores/{vendor_id}/{location_id}/cart/items | Update an item in the grocery store cart. |
| validateGroceryStoreCartAddition | POST /grocery/stores/{vendor_id}/{location_id}/cart/validate | Validate if a product can be added to the cart. |
addToGroceryStoreCart
CartResponse addToGroceryStoreCart(vendor_id, location_id, AddToCartRequest)
Add a product to the grocery store cart.
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| vendor_id | Long | [default to null] | |
| location_id | Long | [default to null] | |
| AddToCartRequest | AddToCartRequest |
Return type
Authorization
HTTP request headers
- Content-Type: application/json; charset=utf-8
- Accept: application/json; charset=utf-8
clearGroceryStoreCart
String clearGroceryStoreCart(vendor_id, location_id)
Clear all items from the grocery store cart.
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| vendor_id | Long | [default to null] | |
| location_id | Long | [default to null] |
Return type
String
Authorization
HTTP request headers
- Content-Type: Not defined
- Accept: application/json; charset=utf-8
getGroceryProduct
ProductResponse getGroceryProduct(id, authorization)
Get grocery product details
Retrieves detailed information about a specific grocery product, including pricing, availability, and customization options.
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| id | Long | Unique identifier of the product | [default to null] |
| authorization | String | Optional JWT bearer token for authenticated requests | [optional] [default to null] |
Return type
Authorization
No authorization required
HTTP request headers
- Content-Type: Not defined
- Accept: application/json; charset=utf-8
getGroceryStore
GroceryStoreDetails getGroceryStore(id, authorization)
Get grocery store (location) details
Retrieves detailed information about a specific grocery store location. The ID is the location ID, not the vendor ID.
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| id | Long | Unique identifier of the grocery store (location ID) | [default to null] |
| authorization | String | Optional JWT bearer token for authenticated requests | [optional] [default to null] |
Return type
Authorization
No authorization required
HTTP request headers
- Content-Type: Not defined
- Accept: application/json; charset=utf-8
getGroceryStoreCart
CartResponse getGroceryStoreCart(vendor_id, location_id)
Get cart for a specific grocery store location.
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| vendor_id | Long | [default to null] | |
| location_id | Long | [default to null] |
Return type
Authorization
HTTP request headers
- Content-Type: Not defined
- Accept: application/json; charset=utf-8
getGroceryStoreProductQuantityInCart
ProductQuantityResponse getGroceryStoreProductQuantityInCart(vendor_id, location_id, product_id)
Get quantity information for a product in the cart.
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| vendor_id | Long | [default to null] | |
| location_id | Long | [default to null] | |
| product_id | Long | [default to null] |
Return type
Authorization
HTTP request headers
- Content-Type: Not defined
- Accept: application/json; charset=utf-8
listGroceryCategories
List listGroceryCategories()
List grocery categories
Retrieves all top-level product categories for grocery stores.
Parameters
This endpoint does not need any parameter.
Return type
Authorization
No authorization required
HTTP request headers
- Content-Type: Not defined
- Accept: application/json; charset=utf-8
listGroceryProducts
ProductListResponse listGroceryProducts(store_id, vendor_id, category_id, sub_category_id, is_open, latitude, longitude, keyword, type, page, per_page, authorization)
List grocery products
Retrieves products from grocery stores with optional filtering by store (location), category, location, and keyword search.
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| store_id | Long | Filter by specific store ID (location ID) | [optional] [default to null] |
| vendor_id | Long | Filter by specific vendor ID (company - includes all locations) | [optional] [default to null] |
| category_id | Long | Filter by category ID | [optional] [default to null] |
| sub_category_id | Long | Filter by sub-category ID | [optional] [default to null] |
| is_open | Boolean | Filter to show only products from currently open stores | [optional] [default to null] |
| latitude | Double | User’s latitude for location-based filtering | [optional] [default to null] |
| longitude | Double | User’s longitude for location-based filtering | [optional] [default to null] |
| keyword | String | Search keyword to filter products | [optional] [default to null] |
| type | ProductListType | Filter/sort type: best (most sales), for_you, flash, new, featured | [optional] [default to null] [enum: vendor, normal, best, for_you, flash, new, featured] |
| page | Long | Page number for pagination (default: 1) | [optional] [default to null] |
| per_page | Long | Items per page for pagination (default: 10) | [optional] [default to null] |
| authorization | String | Optional JWT bearer token for authenticated requests | [optional] [default to null] |
Return type
Authorization
No authorization required
HTTP request headers
- Content-Type: Not defined
- Accept: application/json; charset=utf-8
listGroceryStores
PaginatedResponse_GroceryStoreListItem listGroceryStores(latitude, longitude, radius_km, page, per_page, authorization)
List grocery stores (locations)
Retrieves grocery store locations with optional geo-filtering. Each store is a vendor_location - a vendor can have multiple stores. Results are filtered by proximity within 50km if coordinates are provided.
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| latitude | Double | Latitude for geo-filtering stores within radius | [optional] [default to null] |
| longitude | Double | Longitude for geo-filtering stores within radius | [optional] [default to null] |
| radius_km | Double | Search radius in kilometers (default: 50) | [optional] [default to null] |
| page | Long | Page number for pagination (default: 1) | [optional] [default to null] |
| per_page | Long | Items per page for pagination (default: 20) | [optional] [default to null] |
| authorization | String | Optional JWT bearer token for authenticated requests | [optional] [default to null] |
Return type
PaginatedResponse_GroceryStoreListItem
Authorization
No authorization required
HTTP request headers
- Content-Type: Not defined
- Accept: application/json; charset=utf-8
listGrocerySubcategories
List listGrocerySubcategories(category_id)
List grocery subcategories
Retrieves all subcategories for a specific grocery category.
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| category_id | Long | Parent category ID | [default to null] |
Return type
Authorization
No authorization required
HTTP request headers
- Content-Type: Not defined
- Accept: application/json; charset=utf-8
removeFromGroceryStoreCart
CartResponse removeFromGroceryStoreCart(vendor_id, location_id, RemoveFromCartRequest)
Remove an item from the grocery store cart.
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| vendor_id | Long | [default to null] | |
| location_id | Long | [default to null] | |
| RemoveFromCartRequest | RemoveFromCartRequest |
Return type
Authorization
HTTP request headers
- Content-Type: application/json; charset=utf-8
- Accept: application/json; charset=utf-8
updateGroceryStoreCartItem
CartResponse updateGroceryStoreCartItem(vendor_id, location_id, UpdateCartItemRequest)
Update an item in the grocery store cart.
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| vendor_id | Long | [default to null] | |
| location_id | Long | [default to null] | |
| UpdateCartItemRequest | UpdateCartItemRequest |
Return type
Authorization
HTTP request headers
- Content-Type: application/json; charset=utf-8
- Accept: application/json; charset=utf-8
validateGroceryStoreCartAddition
CartValidationResponse validateGroceryStoreCartAddition(vendor_id, location_id, CartValidationRequest)
Validate if a product can be added to the cart.
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| vendor_id | Long | [default to null] | |
| location_id | Long | [default to null] | |
| CartValidationRequest | CartValidationRequest |
Return type
Authorization
HTTP request headers
- Content-Type: application/json; charset=utf-8
- Accept: application/json; charset=utf-8