Skip to main content
GET
Disponibilidad por rango de fechas (máximo 14 días)
Returns free slots for each day between from and to (both inclusive). Internally expands the range and queries each date in parallel. The range is capped at 14 days to bound per-request cost.

Endpoint

Required scope

scheduling:availability:read

Query params

Example request

Response

200 OK

Each element of days has the same shape as the body of GET /availability. If one of the dates fails individually (upstream timeout or error for that specific day), results: [] is returned for that date and the rest of the range keeps resolving. The error is logged on Keebai’s side.

409 Conflict

Also returned if to < from or the dates are otherwise invalid.

401 Unauthorized · 403 Forbidden

Same semantics as the rest of the public API.

Common patterns

Weekly calendar with availability

Call once per visible week and cache the result by (service, branch, professional, week). When an appointment is created or cancelled, invalidate the matching cache entry.

Authorizations

Authorization
string
header
required

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

Query Parameters

serviceId
string
required

Servicio (requerido)

from
string
required

Fecha desde (YYYY-MM-DD)

to
string
required

Fecha hasta (YYYY-MM-DD, máximo 14 días desde from)

branchId
string
professionalId
string

Response

200 - application/json
from
string
required

YYYY-MM-DD

to
string
required

YYYY-MM-DD

days
object[]
required