Skip to main content
GET
/
v1
/
scheduling
/
appointments
/
{id}
Obtener detalle de una cita
curl --request GET \
  --url https://api.keebai.com/v1/scheduling/appointments/{id} \
  --header 'Authorization: Bearer <token>'
Returns the requested appointment as long as it belongs to the PAT’s tenant.

​
Endpoint

GET https://api.keebai.com/v1/scheduling/appointments/:id

​
Required scope

scheduling:appointments:read

​
Path params

ParamTypeDescription
idstringAppointment id (UUID generated at creation).

​
Example request

curl https://api.keebai.com/v1/scheduling/appointments/9d5b1f4e-7c2a-4a4d-9d3e-9f1b1f8c7a3a \
  -H "Authorization: Bearer kbai_pk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

​
Response

​
200 OK

{
  "_id": "9d5b1f4e-7c2a-4a4d-9d3e-9f1b1f8c7a3a",
  "company": "65a0...",
  "branch": { "id": "65a1f2b3c4d5e6f7a8b9c0d1", "name": "Norte" },
  "service": { "id": "65b1...", "name": "Consulta general" },
  "professional": { "id": "66c1...", "name": "María", "last_name": "Soto" },
  "customer": {
    "name": "Juan",
    "last_name": "Pérez",
    "email": "juan@example.com",
    "phone": "+56912345678"
  },
  "dates": {
    "start": "2026-05-02T13:00:00.000Z",
    "end": "2026-05-02T13:30:00.000Z",
    "timezone": "America/Santiago"
  },
  "status": "confirmed",
  "payment_status": "pending",
  "notes": "Primera consulta",
  "price": 25000,
  "currency": "CLP",
  "created_at": "2026-04-29T12:00:00.000Z",
  "updated_at": "2026-04-29T12:01:00.000Z"
}
FieldTypeDescription
statusstringpending, confirmed, completed, cancelled, blocked, waitlist.
payment_statusstringpending, paid, partial, refunded, cancelled.
dates.timezonestringTz of the branch the appointment was booked at.

​
404 Not Found

The appointment doesn’t exist or belongs to another company.

​
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.

Path Parameters

​
id
string
required

Response

200

Detalle de la cita