Agenda del comensal
POST
Listar tus reservas
POST /api/agenda/list-reservations
Descripción
Lista tus reservas de todos los restaurantes, las próximas o las que ya pasaron.
Detalles
* Las próximas son las que todavía pueden pasar; el resto queda en las que ya pasaron. * Cada reserva trae el restaurante, el día y la hora, cuántos van, la zona y su estado. * La hora viene con la zona horaria del restaurante para leerla con su reloj. * Requiere haber iniciado sesión con tu teléfono.
Permisos requeridos
auth
Request
| Nombre | Tipo | Requerido | Reglas |
|---|---|---|---|
| when | string | Sí |
enum:upcoming,past
|
Paginación
| defaultLimit | 20 |
| maxLimit | 50 |
| allowedSorts | reservedAt, reservationUuid |
| defaultSort | reservedAt |
| defaultDir | asc |
| tieBreak | reservationUuid asc |
Ejemplo de request
curl -X POST https://restofy.pro/api/agenda/list-reservations \
-H "Content-Type: application/json" \
-H "Authorization: Bearer <accessToken>" \
-d '{
"when": "string"
}'Los valores son demo: reemplázalos por datos reales del negocio.
Ejemplo de respuesta
Actualizado: 2026-10-09T02:12:12Z
HTTP 200
Request
{
"when": "upcoming"
}Response
{
"success": true,
"message": "Operación realizada correctamente",
"data": {
"reservations": [
{
"reservationUuid": "678f045c-c386-11f1-a755-a2f78ac020f7",
"slug": "restofy_test_listagendatest_2345_1791511738_tenant",
"restaurantName": "Mi Negocio",
"timezone": "America/Bogota",
"areaName": "Reservas dbbc19",
"reservedAt": "2026-10-09T17:00:00.000Z",
"guestCount": 3,
"status": "confirmed",
"statusLabel": "Confirmada",
"statusTone": "success",
"isAwaitingAdvance": false,
"advanceDueAt": null
}
],
"pagination": {
"page": 1,
"limit": 20,
"total": 1,
"totalPages": 1,
"hasNext": false,
"hasPrev": false
}
}
}