Obtener peticiones por servicio

Este endpoint permite consultar las peticiones de los empleados de un servicio en un intervalo de tiempo no superior a 31 días.

GET /api/v2/businesses/{businessId}/services/{serviceId}/requests?from={yyyy-MM-dd}&to={yyyy-MM-dd}

Si los datos incluidos en la petición son correctos —tanto el businessId como el serviceId—, la respuesta contendrá el listado de peticiones de los empleados del servicio en el intervalo de tiempo indicado en la URL:

Ejemplo de respuesta

[
    {
        "employeeId": "1006350",
        "status": "REQUESTED",
        "type": "MANDATORY",
        "from": "2026-08-27",
        "to": "2026-08-27",
        "fromHour": "20:00",
        "toHour": "22:00",
        "requestedAt": "2026-08-20T10:15:32.123Z"
    },
    {
        "employeeId": "1006350",
        "status": "GRANTED",
        "type": "MAYBE",
        "from": "2026-08-29",
        "to": "2026-08-29",
        "fromHour": "20:00",
        "toHour": "22:00",
        "requestedAt": "2026-08-22T16:42:10.500Z"
    }
]
Detalles

  • employeeId: identificador externo del empleado.

  • status: estado de la petición. Los posibles valores son REQUESTED (solicitada), GRANTED (concedida) y DENIED (denegada).

  • type: tipo de disponibilidad que se aplica a la petición. Los posibles valores son MANDATORY (disponibilidad para trabajar), MAYBE (disponibilidad) y NON_WORKED (día libre).

  • from: fecha de inicio de la petición en formato yyyy-MM-dd.

  • to: fecha de fin de la petición en formato yyyy-MM-dd.

  • fromHour: hora de inicio de la petición en formato HH:mm. Se considera la hora local, es decir, la zona horaria del servicio.

  • toHour: hora de fin de la petición en formato HH:mm. Se considera la hora local, es decir, la zona horaria del servicio.

  • comments: texto libre que puede acompañar a la petición.

  • recover: tipo de recuperación que indica cómo se podría compensar la petición del empleado. Las opciones son FREE (día libre) o NONE (no se ofrece ninguna compensación por la petición).

  • requestedAt: fecha y hora de creación de la petición, en formato yyyy-MM-ddTHH:mm:ss.SSSZ.

Como se puede apreciar en el ejemplo, la información de la respuesta dependerá de los datos que se hayan definido para cada petición y el estado de estas en el sistema.

Consideraciones

Los campos fromHour y toHour devuelven los valores en la hora local, determinada por la zona horaria configurada para el servicio.

Si no hay peticiones para el servicio en el intervalo de la consulta, la petición devolverá un array vacío [].

Códigos de error

Además de los errores comunes, este endpoint puede devolver los siguientes códigos:

Código Mensaje Descripción

400 Bad Request

from and to cannot be greater than 31

El rango entre from y to supera los 31 días permitidos. Se recomienda acotar el intervalo de consulta.

Enlaces de interés

¿Qué es una petición?