Skip to Content

FoodApi

All URIs are relative to https://business.apis.kesk.app/v1 

MethodHTTP requestDescription
addToFoodCartPOST /food/restaurants/{vendor_id}/{location_id}/cart/itemsAdd a product to the restaurant cart.
clearFoodCartDELETE /food/restaurants/{vendor_id}/{location_id}/cartClear all items from the restaurant cart.
getFoodCartGET /food/restaurants/{vendor_id}/{location_id}/cartGet cart for a specific restaurant location.
getFoodProductGET /food/products/{id}Get food product details
getFoodProductQuantityInCartGET /food/restaurants/{vendor_id}/{location_id}/cart/product/{product_id}/quantityGet quantity information for a product in the cart.
getRestaurantGET /food/restaurants/{id}Get restaurant (location) details
listFoodCategoriesGET /food/categoriesList food categories
listFoodProductsGET /food/productsList food products
listFoodSubcategoriesGET /food/categories/{category_id}/subcategoriesList food subcategories
listRestaurantsGET /food/restaurantsList restaurants (locations)
removeFromFoodCartDELETE /food/restaurants/{vendor_id}/{location_id}/cart/itemsRemove an item from the restaurant cart.
updateFoodCartItemPUT /food/restaurants/{vendor_id}/{location_id}/cart/itemsUpdate an item in the restaurant cart.
validateFoodCartAdditionPOST /food/restaurants/{vendor_id}/{location_id}/cart/validateValidate if a product can be added to the cart.

addToFoodCart

CartResponse addToFoodCart(vendor_id, location_id, AddToCartRequest)

Add a product to the restaurant cart.

Parameters

NameTypeDescriptionNotes
vendor_idLong[default to null]
location_idLong[default to null]
AddToCartRequestAddToCartRequest

Return type

CartResponse

Authorization

JwtAuthScheme

HTTP request headers

  • Content-Type: application/json; charset=utf-8
  • Accept: application/json; charset=utf-8

clearFoodCart

String clearFoodCart(vendor_id, location_id)

Clear all items from the restaurant cart.

Parameters

NameTypeDescriptionNotes
vendor_idLong[default to null]
location_idLong[default to null]

Return type

String

Authorization

JwtAuthScheme

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json; charset=utf-8

getFoodCart

CartResponse getFoodCart(vendor_id, location_id)

Get cart for a specific restaurant location.

Parameters

NameTypeDescriptionNotes
vendor_idLong[default to null]
location_idLong[default to null]

Return type

CartResponse

Authorization

JwtAuthScheme

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json; charset=utf-8

getFoodProduct

ProductResponse getFoodProduct(id, authorization)

Get food product details

Retrieves detailed information about a specific menu item, including pricing, customization options, and nutritional info.

Parameters

NameTypeDescriptionNotes
idLongUnique identifier of the product[default to null]
authorizationStringOptional JWT bearer token for authenticated requests[optional] [default to null]

Return type

ProductResponse

Authorization

No authorization required

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json; charset=utf-8

getFoodProductQuantityInCart

ProductQuantityResponse getFoodProductQuantityInCart(vendor_id, location_id, product_id)

Get quantity information for a product in the cart.

Parameters

NameTypeDescriptionNotes
vendor_idLong[default to null]
location_idLong[default to null]
product_idLong[default to null]

Return type

ProductQuantityResponse

Authorization

JwtAuthScheme

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json; charset=utf-8

getRestaurant

RestaurantDetails getRestaurant(id, authorization)

Get restaurant (location) details

Retrieves detailed information about a specific restaurant location. The ID is the location ID, not the vendor ID.

Parameters

NameTypeDescriptionNotes
idLongUnique identifier of the restaurant (location ID)[default to null]
authorizationStringOptional JWT bearer token for authenticated requests[optional] [default to null]

Return type

RestaurantDetails

Authorization

No authorization required

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json; charset=utf-8

listFoodCategories

List listFoodCategories()

List food categories

Retrieves all food/cuisine categories for restaurants.

Parameters

This endpoint does not need any parameter.

Return type

List

Authorization

No authorization required

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json; charset=utf-8

listFoodProducts

ProductListResponse listFoodProducts(restaurant_id, vendor_id, menu_id, category_id, sub_category_id, is_open, latitude, longitude, keyword, type, page, per_page, authorization)

List food products

Retrieves menu items from restaurants with optional filtering by restaurant (location), category, and keyword search.

Parameters

NameTypeDescriptionNotes
restaurant_idLongFilter by specific restaurant ID (location ID)[optional] [default to null]
vendor_idLongFilter by specific vendor ID (company - includes all locations)[optional] [default to null]
menu_idLongFilter by menu ID[optional] [default to null]
category_idLongFilter by category ID[optional] [default to null]
sub_category_idLongFilter by sub-category ID[optional] [default to null]
is_openBooleanFilter to show only products from currently open restaurants[optional] [default to null]
latitudeDoubleUser’s latitude for location-based filtering[optional] [default to null]
longitudeDoubleUser’s longitude for location-based filtering[optional] [default to null]
keywordStringSearch keyword to filter products[optional] [default to null]
typeProductListTypeFilter/sort type: best (most sales), for_you, flash, new, featured[optional] [default to null] [enum: vendor, normal, best, for_you, flash, new, featured]
pageLongPage number for pagination (default: 1)[optional] [default to null]
per_pageLongItems per page for pagination (default: 10)[optional] [default to null]
authorizationStringOptional JWT bearer token for authenticated requests[optional] [default to null]

Return type

ProductListResponse

Authorization

No authorization required

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json; charset=utf-8

listFoodSubcategories

List listFoodSubcategories(category_id)

List food subcategories

Retrieves all subcategories for a specific food category.

Parameters

NameTypeDescriptionNotes
category_idLongParent category ID[default to null]

Return type

List

Authorization

No authorization required

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json; charset=utf-8

listRestaurants

PaginatedResponse_RestaurantListItem listRestaurants(latitude, longitude, radius_km, page, per_page, authorization)

List restaurants (locations)

Retrieves restaurant locations with optional geo-filtering. Each restaurant is a vendor_location - a vendor can have multiple restaurants. Results are filtered by proximity within 50km if coordinates are provided.

Parameters

NameTypeDescriptionNotes
latitudeDoubleLatitude for geo-filtering restaurants within radius[optional] [default to null]
longitudeDoubleLongitude for geo-filtering restaurants within radius[optional] [default to null]
radius_kmDoubleSearch radius in kilometers (default: 50)[optional] [default to null]
pageLongPage number for pagination (default: 1)[optional] [default to null]
per_pageLongItems per page for pagination (default: 20)[optional] [default to null]
authorizationStringOptional JWT bearer token for authenticated requests[optional] [default to null]

Return type

PaginatedResponse_RestaurantListItem

Authorization

No authorization required

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json; charset=utf-8

removeFromFoodCart

CartResponse removeFromFoodCart(vendor_id, location_id, RemoveFromCartRequest)

Remove an item from the restaurant cart.

Parameters

NameTypeDescriptionNotes
vendor_idLong[default to null]
location_idLong[default to null]
RemoveFromCartRequestRemoveFromCartRequest

Return type

CartResponse

Authorization

JwtAuthScheme

HTTP request headers

  • Content-Type: application/json; charset=utf-8
  • Accept: application/json; charset=utf-8

updateFoodCartItem

CartResponse updateFoodCartItem(vendor_id, location_id, UpdateCartItemRequest)

Update an item in the restaurant cart.

Parameters

NameTypeDescriptionNotes
vendor_idLong[default to null]
location_idLong[default to null]
UpdateCartItemRequestUpdateCartItemRequest

Return type

CartResponse

Authorization

JwtAuthScheme

HTTP request headers

  • Content-Type: application/json; charset=utf-8
  • Accept: application/json; charset=utf-8

validateFoodCartAddition

CartValidationResponse validateFoodCartAddition(vendor_id, location_id, CartValidationRequest)

Validate if a product can be added to the cart.

Parameters

NameTypeDescriptionNotes
vendor_idLong[default to null]
location_idLong[default to null]
CartValidationRequestCartValidationRequest

Return type

CartValidationResponse

Authorization

JwtAuthScheme

HTTP request headers

  • Content-Type: application/json; charset=utf-8
  • Accept: application/json; charset=utf-8