Consultar las vacantes publicadas

Este endpoint devuelve las vacantes de un negocio dentro de un rango de fechas, incluyendo el producto y los empleados a los que se les ofreció cada una.

GET /api/v1/businesses/{businessId}/vacancies?from={yyyy-MM-dd}&to={yyyy-MM-dd}

Si los datos incluidos en la petición son correctos, la respuesta contendrá el listado de vacantes cuyo día se encuentra entre las fechas indicadas en los parámetros from y to (ambas incluidas).

Ejemplo de respuesta

{
    "vacancies": [
        {
            "id": "3hfd3",
            "product": "0001-G",
            "day": "2026-07-16",
            "publishToSiblings": false,
            "shifts": [
                {
                    "start": "2026-07-16T12:00:00+02:00",
                    "end": "2026-07-16T19:00:00+02:00"
                }
            ],
            "employees": [
                "1006370",
                "1006350"
            ],
            "acceptedEmployee": "1006350"
        }
    ]
}
Detalles

  • id: identificador externo de la vacante.

  • product: identificador externo del producto vinculado con la vacante.

  • day: día de la vacante en formato yyyy-MM-dd.

  • publishToSiblings: indica si la vacante se publicó también para los productos hermanos (true) o solo para el producto indicado (false).

  • shifts: turnos definidos para la vacante. Los campos start y end se devuelven en la hora local del servicio, incluyendo su zona horaria correspondiente.

  • employees: listado de identificadores externos de todos los empleados a los que se les ofreció la vacante.

  • acceptedEmployee: identificador externo del empleado que aceptó la vacante. Si todavía no ha sido aceptada por nadie, este campo no aparece en la respuesta.

Aspectos que tener en cuenta

Si no hay vacantes publicadas para el periodo de tiempo indicado, la petición devolverá un listado vacancies vacío.

Si el parámetro to es anterior a from, la petición devolverá un error 400 Bad Request indicando en el mensaje To can not be before from.

Enlaces de interés

¿Cómo registrar una vacante?