Listar servicios disponibles del tenant
Resources
GET /v1/scheduling/services
List the tenant’s available services. Supports filtering by branch, full-text search, and filtering by status.
GET
Listar servicios disponibles del tenant
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
Required scope
scheduling:services:read
Query params
| Param | Type | Default | Description |
|---|---|---|---|
branchId | string | — | Filter services available at a specific branch. |
search | string | — | Full-text search over name and description. |
status | string | — | Filter by service status (active, inactive). |
skip | number | 0 | Pagination offset. |
limit | number | 50 | Page size (max 200). |
Example request
Response
200 OK
List of services. Each item includes at least:| Field | Type | Description |
|---|---|---|
_id | string | Service id. Used as service_id in availability and when creating appointments. |
name | string | Service display name. |
description | string | Free-form description. |
duration_minutes | number | Default duration in minutes. Defines slot size. |
bufferBefore / bufferAfter | number | Buffer minutes around the slot. |
time_rules | object | { earliest_start, latest_end } — restricts the window during which booking is allowed. |
allowedProfessionals | string[] | Ids of professionals allowed to deliver the service. |
price / currency | — | Reference price. |
status | string | active or inactive. |
401 Unauthorized · 403 Forbidden
Same semantics as the rest of the public API.Authorizations
Personal Access Token con prefijo kbai_pk_. Generar desde el portal con permiso developer.manage_tokens.
Query Parameters
Filtrar por sucursal
Estado del servicio (active/inactive)
Required range:
x >= 0Required range:
1 <= x <= 200Response
200
Listado de servicios