Restofy Docs
Panel POST

Clientes y sala

POST /api/dashboard/get-guest-analytics

Descripción

Analítica de clientes del período: ocasiones, grupos, atributos y reservas.

Detalles

Entrega cuántas visitas hubo por ocasión especial, por tipo de grupo y por atributo de invitado registrado. Incluye la cantidad de reservas y de clientes nuevos del período con su evolución diaria. Si no se envía rango, se asume la última semana.

Permisos requeridos

dashboards.module

Request

Nombre Tipo Requerido Reglas
dateFrom string No
min:10 max:10
dateTo string No
min:10 max:10

Ejemplo de request

curl -X POST https://app.restofy.co/api/dashboard/get-guest-analytics \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <accessToken>"

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

Ejemplo de respuesta

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

Request

[]

Response

{
    "success": true,
    "message": "Operación realizada correctamente",
    "data": {
        "occasions": [
            {
                "name": "Cumpleaños",
                "count": 0
            },
            {
                "name": "Aniversario",
                "count": 0
            },
            {
                "name": "Pedida de Mano",
                "count": 0
            },
            {
                "name": "Graduación",
                "count": 0
            },
            {
                "name": "Despedida",
                "count": 0
            }
        ],
        "groups": [
            {
                "name": "Pareja",
                "count": 0
            },
            {
                "name": "Familia",
                "count": 0
            },
            {
                "name": "Amigos",
                "count": 0
            },
            {
                "name": "Compañeros",
                "count": 0
            },
            {
                "name": "Individual",
                "count": 0
            },
            {
                "name": "Negocios",
                "count": 0
            },
            {
                "name": "Turista",
                "count": 0
            },
            {
                "name": "Evento",
                "count": 0
            }
        ],
        "attributes": [
            {
                "name": "Niños",
                "count": 0
            },
            {
                "name": "Mascotas",
                "count": 0
            },
            {
                "name": "Adultos Mayores",
                "count": 0
            },
            {
                "name": "Sillas de Ruedas",
                "count": 0
            },
            {
                "name": "Bebés",
                "count": 0
            },
            {
                "name": "Embarazadas",
                "count": 0
            },
            {
                "name": "Alergias Severas",
                "count": 0
            }
        ],
        "reservations": {
            "count": 1,
            "byDay": [
                {
                    "label": "9 jul",
                    "count": 0
                },
                {
                    "label": "10 jul",
                    "count": 0
                },
                {
                    "label": "11 jul",
                    "count": 0
                },
                {
                    "label": "12 jul",
                    "count": 0
                },
                {
                    "label": "13 jul",
                    "count": 0
                },
                {
                    "label": "14 jul",
                    "count": 0
                },
                {
                    "label": "15 jul",
                    "count": 1
                }
            ]
        },
        "newCustomers": {
            "count": 2,
            "byDay": [
                {
                    "label": "9 jul",
                    "count": 0
                },
                {
                    "label": "10 jul",
                    "count": 0
                },
                {
                    "label": "11 jul",
                    "count": 0
                },
                {
                    "label": "12 jul",
                    "count": 0
                },
                {
                    "label": "13 jul",
                    "count": 0
                },
                {
                    "label": "14 jul",
                    "count": 0
                },
                {
                    "label": "15 jul",
                    "count": 2
                }
            ]
        }
    }
}