Skip to main content
GET
/
v1
/
scheduling
/
availability
/
next
Próximas horas disponibles más cercanas
curl --request GET \
  --url https://api.keebai.com/v1/scheduling/availability/next \
  --header 'Authorization: Bearer <token>'
Returns the next available slots starting from fromDate (default: today in the branch’s tz), walking forward up to maxDays days and stopping once limit slots per professional have been collected. Designed for “first available time” flows.

​
Endpoint

GET https://api.keebai.com/v1/scheduling/availability/next

​
Required scope

scheduling:availability:read

​
Query params

ParamTypeRequiredDefaultDescription
serviceIdstringYes—Service to book.
branchIdstringNotenant’s firstBranch.
professionalIdstringNo—Restrict to a single professional.
fromDatestringNotodayDate to start the search from (YYYY-MM-DD).
maxDaysnumberNo14Maximum number of days to walk forward. Range 1..60.
limitnumberNo5Maximum number of slots to return per professional. Range 1..20.

​
Example request

curl -G https://api.keebai.com/v1/scheduling/availability/next \
  -H "Authorization: Bearer kbai_pk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
  --data-urlencode "serviceId=65b1c2d3e4f5a6b7c8d9e0f1" \
  --data-urlencode "branchId=65a1f2b3c4d5e6f7a8b9c0d1" \
  --data-urlencode "maxDays=14" \
  --data-urlencode "limit=5"

​
Response

​
200 OK

{
  "results": [
    {
      "professional": {
        "id": "66c1d2e3f4a5b6c7d8e9f0a1",
        "name": "María",
        "last_name": "Soto"
      },
      "slots": [
        { "date": "2026-05-02", "time": "09:00" },
        { "date": "2026-05-02", "time": "09:30" },
        { "date": "2026-05-03", "time": "10:00" }
      ]
    }
  ]
}
FieldTypeDescription
results[].professionalobjectProfessional with id and name.
results[].slots[]arrayFree slots ordered from soonest to latest.

​
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

​
serviceId
string
required

Servicio (requerido)

​
branchId
string
​
professionalId
string
​
fromDate
string

Fecha desde (YYYY-MM-DD)

​
maxDays
number
default:14
Required range: 1 <= x <= 60
​
limit
number
default:5
Required range: 1 <= x <= 20

Response

200

Próximas horas disponibles por profesional