Obtener 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.

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

To can not be before from

La fecha to es anterior a from.

Enlaces de interés

¿Cómo registrar una vacante?