Skip to main content
GET
/
v1
/
scheduling
/
professionals
Listar profesionales del tenant
curl --request GET \
  --url https://api.keebai.com/v1/scheduling/professionals \
  --header 'Authorization: Bearer <token>'
Returns the tenant’s professionals. Search uses the professional text index over name, last_name, email, and cargo, so it covers searches by name as well as by specialty.

​
Endpoint

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

​
Required scope

scheduling:professionals:read

​
Query params

ParamTypeDefaultDescription
branchIdstring—Filter professionals assigned to a branch.
serviceIdstring—Filter professionals allowed to deliver a service.
searchstring—Full-text search over name, last name, email, and role.
statusstring—active, inactive, or on_leave.
skipnumber0Pagination offset.
limitnumber50Page size (max 200).

​
Example request

curl -G https://api.keebai.com/v1/scheduling/professionals \
  -H "Authorization: Bearer kbai_pk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
  --data-urlencode "branchId=65a1f2b3c4d5e6f7a8b9c0d1" \
  --data-urlencode "serviceId=65b1c2d3e4f5a6b7c8d9e0f1" \
  --data-urlencode "status=active"

​
Response

​
200 OK

Each item includes at least:
FieldTypeDescription
_idstringProfessional id. Used as professional_id in availability and when creating appointments.
name / last_namestringFull name.
cargostringRole or title. Useful to display in the UI.
specialtiesstring[]Declared specialties.
email / phonestringProfessional contact details.
branchesstring[]Branches where they work.
servicesstring[]Services they can deliver.
statusstringactive, inactive, or on_leave.

​
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

​
serviceId
string

Filtrar por servicio prestado

​
search
string
​
status
string

Estado (active/inactive/on_leave)

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

Response

200

Listado de profesionales