Restofy Docs
Reservas POST

Listar reservas del mes

POST /api/reservations/list-month-reservations

Descripción

Lista las reservas activas cuyo horario cae dentro de un mes calendario.

Detalles

* Filtra las reservas del mes indicado según la zona horaria del restaurante. * Acepta filtros opcionales por estado y área de reserva. * Devuelve todas las reservas del mes sin límite de resultados.

Permisos requeridos

reservations.module

Request

Nombre Tipo Requerido Reglas
year int Sí
min_value:2000 max_value:2100
month int Sí
min_value:1 max_value:12
status string No
enum:pending,confirmed,seated,completed,no_show,cancelled
reservationAreaId int No
min_value:1

Ejemplo de request

curl -X POST https://app.restofy.co/api/reservations/list-month-reservations \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <accessToken>" \
  -d '{
    "year": 1,
    "month": 1
}'

Los valores son demo: reemplázalos por datos reales del negocio.

Ejemplo de respuesta

Actualizado: 2026-07-15T13:20:48Z
HTTP 200

Request

{
    "year": 2026,
    "month": 7
}

Response

{
    "success": true,
    "message": "Operación realizada correctamente",
    "data": {
        "reservations": [
            {
                "reservationId": 1,
                "reservationUuid": "bbbbbbbb-bbbb-bbbb-bbbb-bbbbbbbbbb01",
                "partyId": 1,
                "partyName": "Cliente Crédito",
                "partyPhone": "3000000099",
                "reservationAreaId": 1,
                "assignedTableId": 1,
                "guestCount": 2,
                "reservedAt": "2026-07-15T19:00:00.000Z",
                "durationMinutes": 90,
                "status": "confirmed",
                "prepaidAccountId": null,
                "advanceAmountCents": null,
                "isAvailable": 1
            },
            {
                "reservationId": 3,
                "reservationUuid": "bbbbbbbb-bbbb-bbbb-bbbb-bbbbbbbbbb03",
                "partyId": 1,
                "partyName": "Cliente Crédito",
                "partyPhone": "3000000099",
                "reservationAreaId": 1,
                "assignedTableId": 3,
                "guestCount": 3,
                "reservedAt": "2026-07-22T13:18:27.000Z",
                "durationMinutes": 90,
                "status": "confirmed",
                "prepaidAccountId": null,
                "advanceAmountCents": null,
                "isAvailable": 1
            }
        ],
        "rangeStart": "2026-07-01T05:00:00.000Z",
        "rangeEnd": "2026-08-01T05:00:00.000Z"
    }
}
Volver a Reservas