ServicesApi
All URIs are relative to https://business.apis.kesk.app/v1
| Method | HTTP request | Description |
|---|---|---|
| getService | GET /service-booking/services/{id} | Retrieve detailed service information |
| getServiceDurations | GET /service-booking/services/durations | List available service duration options |
| getServiceProvider | GET /service-booking/stores/{id} | Get service provider (location) details |
| getServices | GET /service-booking/services | Browse available services |
| listServiceCategories | GET /service-booking/categories | List service categories |
| listServiceProviders | GET /service-booking/stores | List service providers (locations) |
| listServiceSubcategories | GET /service-booking/categories/{category_id}/subcategories | List service subcategories |
getService
ServiceResponse getService(id, authorization)
Retrieve detailed service information
Fetches complete details for a specific service including pricing, duration, photos, and vendor information. Returns comprehensive service data for display in service detail views.
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| id | Long | Unique identifier of the service to retrieve | [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
getServiceDurations
PaginatedResponse_string getServiceDurations(page, per_page)
List available service duration options
Returns all valid duration options that can be used when creating or filtering services. Useful for populating duration selection dropdowns in service creation or search interfaces.
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| page | Integer | Page number for pagination (default: 1) | [optional] [default to null] |
| per_page | Integer | Items per page for pagination (default: 20) | [optional] [default to null] |
Return type
Authorization
HTTP request headers
- Content-Type: Not defined
- Accept: application/json; charset=utf-8
getServiceProvider
ServiceProviderDetails getServiceProvider(id, authorization)
Get service provider (location) details
Retrieves detailed information about a specific service provider location. The ID is the location ID, not the vendor ID.
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| id | Long | Unique identifier of the service provider (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
getServices
PaginatedResponse_ServiceListItemResponse getServices(type, keyword, category_id, menu_id, is_open, vendor_type_id, vendor_id, vendor_location_id, latitude, longitude, page, per_page, authorization)
Browse available services
Retrieves a list of services with optional filtering by category, location, vendor, and availability. Supports keyword search and pagination for efficient service discovery across the platform.
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| type | String | Service type filter (e.g., “delivery”, “pickup”) | [optional] [default to null] |
| keyword | String | Search keyword to filter services by name or description | [optional] [default to null] |
| category_id | Long | Filter services by category identifier | [optional] [default to null] |
| menu_id | Long | Filter services by menu identifier | [optional] [default to null] |
| is_open | Boolean | Filter by vendor open/closed status | [optional] [default to null] |
| vendor_type_id | Long | Filter services by vendor type identifier | [optional] [default to null] |
| vendor_id | Long | Filter services by specific vendor identifier | [optional] [default to null] |
| vendor_location_id | Long | Filter services by specific vendor location identifier | [optional] [default to null] |
| latitude | Double | User’s latitude coordinate for location-based filtering | [optional] [default to null] |
| longitude | Double | User’s longitude coordinate for location-based filtering | [optional] [default to null] |
| page | Integer | Page number for pagination (starts at 1, defaults to 1 if not provided) | [optional] [default to null] |
| per_page | Integer | The number of services per page (defaults to 10 if not provided, must be greater than 0) | [optional] [default to null] |
| authorization | String | Optional JWT bearer token for authenticated requests | [optional] [default to null] |
Return type
PaginatedResponse_ServiceListItemResponse
Authorization
No authorization required
HTTP request headers
- Content-Type: Not defined
- Accept: application/json; charset=utf-8
listServiceCategories
List listServiceCategories()
List service categories
Retrieves service categories for filtering and browsing.
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
listServiceProviders
PaginatedResponse_ServiceProviderListItem listServiceProviders(latitude, longitude, radius_km, page, per_page, authorization)
List service providers (locations)
Retrieves service provider locations (salons, spas, etc.) with optional geo-filtering. Each provider is a vendor_location - a vendor can have multiple locations. Results are filtered by proximity within 50km if coordinates are provided.
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| latitude | Double | Latitude for geo-filtering service providers within radius | [optional] [default to null] |
| longitude | Double | Longitude for geo-filtering service providers 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_ServiceProviderListItem
Authorization
No authorization required
HTTP request headers
- Content-Type: Not defined
- Accept: application/json; charset=utf-8
listServiceSubcategories
List listServiceSubcategories(category_id)
List service subcategories
Retrieves subcategories for a specific service 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