PharmacyApi
All URIs are relative to https://business.apis.kesk.app/v1
| Method | HTTP request | Description |
|---|---|---|
| addToPharmacyCart | POST /pharmacy/stores/{vendor_id}/{location_id}/cart/items | Add a product to the pharmacy cart. |
| clearPharmacyCart | DELETE /pharmacy/stores/{vendor_id}/{location_id}/cart | Clear all items from the pharmacy cart. |
| getPharmacy | GET /pharmacy/stores/{id} | Get pharmacy (location) details |
| getPharmacyCart | GET /pharmacy/stores/{vendor_id}/{location_id}/cart | Get cart for a specific pharmacy location. |
| getPharmacyProduct | GET /pharmacy/products/{id} | Get pharmacy product details |
| getPharmacyProductQuantityInCart | GET /pharmacy/stores/{vendor_id}/{location_id}/cart/product/{product_id}/quantity | Get quantity information for a product in the cart. |
| listPharmacies | GET /pharmacy/stores | List pharmacies (locations) |
| listPharmacyCategories | GET /pharmacy/categories | List pharmacy categories |
| listPharmacyProducts | GET /pharmacy/products | List pharmacy products |
| listPharmacySubcategories | GET /pharmacy/categories/{category_id}/subcategories | List pharmacy subcategories |
| removeFromPharmacyCart | DELETE /pharmacy/stores/{vendor_id}/{location_id}/cart/items | Remove an item from the pharmacy cart. |
| updatePharmacyCartItem | PUT /pharmacy/stores/{vendor_id}/{location_id}/cart/items | Update an item in the pharmacy cart. |
| validatePharmacyCartAddition | POST /pharmacy/stores/{vendor_id}/{location_id}/cart/validate | Validate if a product can be added to the cart. |
addToPharmacyCart
CartResponse addToPharmacyCart(vendor_id, location_id, AddToCartRequest)
Add a product to the pharmacy 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
clearPharmacyCart
String clearPharmacyCart(vendor_id, location_id)
Clear all items from the pharmacy 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
getPharmacy
PharmacyStoreDetails getPharmacy(id, authorization)
Get pharmacy (location) details
Retrieves detailed information about a specific pharmacy location. The ID is the location ID, not the vendor ID.
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| id | Long | Unique identifier of the pharmacy (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
getPharmacyCart
CartResponse getPharmacyCart(vendor_id, location_id)
Get cart for a specific pharmacy 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
getPharmacyProduct
ProductResponse getPharmacyProduct(id, authorization)
Get pharmacy product details
Retrieves detailed information about a specific pharmacy 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
getPharmacyProductQuantityInCart
ProductQuantityResponse getPharmacyProductQuantityInCart(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
listPharmacies
PaginatedResponse_PharmacyStoreListItem listPharmacies(latitude, longitude, radius_km, page, per_page, authorization)
List pharmacies (locations)
Retrieves pharmacy locations with optional geo-filtering. Each pharmacy is a vendor_location - a vendor can have multiple pharmacies. Results are filtered by proximity within 50km if coordinates are provided.
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| latitude | Double | Latitude for geo-filtering pharmacies within radius | [optional] [default to null] |
| longitude | Double | Longitude for geo-filtering pharmacies 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_PharmacyStoreListItem
Authorization
No authorization required
HTTP request headers
- Content-Type: Not defined
- Accept: application/json; charset=utf-8
listPharmacyCategories
List listPharmacyCategories()
List pharmacy categories
Retrieves all top-level product categories for pharmacies.
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
listPharmacyProducts
ProductListResponse listPharmacyProducts(store_id, vendor_id, category_id, sub_category_id, is_open, latitude, longitude, keyword, type, page, per_page, authorization)
List pharmacy products
Retrieves products from pharmacies 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
listPharmacySubcategories
List listPharmacySubcategories(category_id)
List pharmacy subcategories
Retrieves all subcategories for a specific pharmacy 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
removeFromPharmacyCart
CartResponse removeFromPharmacyCart(vendor_id, location_id, RemoveFromCartRequest)
Remove an item from the pharmacy 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
updatePharmacyCartItem
CartResponse updatePharmacyCartItem(vendor_id, location_id, UpdateCartItemRequest)
Update an item in the pharmacy 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
validatePharmacyCartAddition
CartValidationResponse validatePharmacyCartAddition(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