Karma Common API
​number · required​string · enum · required
​number · required​number · min: 0 · max: 120​number · min: 15 · max: 480​boolean​number · min: 1 · max: 100​number · min: 0 · max: 168​number · min: 1 · max: 365​number[]​object​number · enum​number · min: 0 · max: 50​string · enum​number | null · min: 5 · max: 120​number | null · min: 0 · max: 168​number | null · min: 1 · max: 365​number | null · min: 1 · max: 50​string · enum · required
Location booking settings and configuration
Get location booking settings
GET
https://common-api.karma.life
/api/v1/locations/{locationId}/booking-settings
Get booking settings for a location. Creates default settings if none exist.
Permissions: 🔵 bookings.read
path Parameters
locationIdLocation ID
Get location booking settings › Responses
Default Response
statusEnum values:
success
​object · required
​object · required
Update location booking settings
PUT
https://common-api.karma.life
/api/v1/locations/{locationId}/booking-settings
Update booking settings for a location.
Permissions: ⚪ bookings.manage
path Parameters
locationIdLocation ID
Update location booking settings › Request Body
bufferMinutesTime buffer between bookings (minutes)
defaultDurationMinutesDefault booking duration (minutes)
autoOptimizeEnabledEnable automatic table optimization
maxPartySizeMaximum party size allowed
minAdvanceHoursMinimum hours in advance
maxAdvanceDaysMaximum days in advance
allowedPartySizesSpecific party sizes allowed
operatingHoursPer-day booking hours override
slotIntervalMinutesTime slot interval (minutes)
Enum values:
15
30
45
60
90
overbookingBufferPercentageOverbooking buffer percentage
confirmationModeBooking confirmation mode
Enum values:
instant
request_based
autoNoShowDelayMinutesAuto no-show delay (minutes)
cancellationPolicyHoursCancellation policy (hours before)
bookingWindowDaysBooking window (days ahead)
maxActiveBookingsPerGuestMax active bookings per guest
Update location booking settings › Responses
Default Response
statusEnum values:
success
​object · required
​object · required