Skip to main content
GET
/
v1
/
scheduling
/
services
Listar servicios disponibles del tenant
curl --request GET \
  --url https://api.keebai.com/v1/scheduling/services \
  --header 'Authorization: Bearer <token>'
Returns the services configured for the tenant resolved from the PAT. Search uses the service text index (name, description) in Spanish. Services include duration, time restrictions, and the professionals or resources allowed to deliver them.

Endpoint

GET https://api.keebai.com/v1/scheduling/services

Required scope

scheduling:services:read

Query params

ParamTypeDefaultDescription
branchIdstringFilter services available at a specific branch.
searchstringFull-text search over name and description.
statusstringFilter by service status (active, inactive).
skipnumber0Pagination offset.
limitnumber50Page size (max 200).

Example request

curl -G https://api.keebai.com/v1/scheduling/services \
  -H "Authorization: Bearer kbai_pk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
  --data-urlencode "branchId=65a1f2b3c4d5e6f7a8b9c0d1" \
  --data-urlencode "search=consulta general"

Response

200 OK

List of services. Each item includes at least:
FieldTypeDescription
_idstringService id. Used as service_id in availability and when creating appointments.
namestringService display name.
descriptionstringFree-form description.
duration_minutesnumberDefault duration in minutes. Defines slot size.
bufferBefore / bufferAfternumberBuffer minutes around the slot.
time_rulesobject{ earliest_start, latest_end } — restricts the window during which booking is allowed.
allowedProfessionalsstring[]Ids of professionals allowed to deliver the service.
price / currencyReference price.
statusstringactive or inactive.

401 Unauthorized · 403 Forbidden

Same semantics as the rest of the public API.

Authorizations

Authorization
string
header
required

Personal Access Token con prefijo kbai_pk_. Generar desde el portal con permiso developer.manage_tokens.

Query Parameters

branchId
string

Filtrar por sucursal

status
string

Estado del servicio (active/inactive)

skip
number
default:0
Required range: x >= 0
limit
number
default:50
Required range: 1 <= x <= 200

Response

200

Listado de servicios