Base URL https://api.afer.pro Referencia aferapp.com Reservar demo
Equipo y control horario

Ausencias y vacaciones

GET https://api.afer.pro/api/v1/time-off
Alias en castellano (v0, sigue operativo): POST https://api.afer.pro/consultarAusencias

Las ausencias que solapan un período, con su tipo, si están autorizadas y cuántos días caen dentro.

Vacaciones, bajas, permisos retribuidos y cualquier otro tipo de día configurado en tu cuenta. Se devuelve toda ausencia que solape el rango consultado, no solo las contenidas en él: unas vacaciones del 28 de abril al 4 de mayo aparecen al consultar mayo.

dias_en_periodo son los días naturales del tramo que caen dentro del rango que has pedido — en el ejemplo anterior, 4 y no 7. Es el número que quieres para repartir ausencias por mes sin contarlas dos veces.

Por defecto las solicitudes rechazadas quedan fuera.

Autenticación

Envía tus claves API en las cabeceras X-API-KEY y X-API-SECRET. La cuenta sobre la que se opera se resuelve automáticamente a partir de la clave. Cómo obtener tus claves →

Este endpoint requiere autenticación con API key: sin credenciales responde 401.

Parámetros del cuerpo

El cuerpo de la petición es un objeto JSON con Content-Type: application/json.

fecha_iniciodate
obligatorio
Inicio del período, incluido. Formato YYYY-MM-DD.
fecha_findate
obligatorio
Fin del período, incluido.
empleadoIdstring
opcional
Solo las ausencias de esta persona.
tipostring
opcional
Código de tipo de día, el que devuelve el campo tipo de la respuesta (por ejemplo vacaciones).
incluir_rechazadasbool
opcional
Con true se incluyen también las solicitudes rechazadas.

Ejemplo de petición

curl -X GET 'https://api.afer.pro/api/v1/time-off?fecha_inicio=2026-05-01&fecha_fin=2026-05-31' \
  -H 'X-API-KEY: afer_tk_TU_TOKEN' \
  -H 'X-API-SECRET: afer_sk_TU_SECRET'
<?php

$ch = curl_init('https://api.afer.pro/api/v1/time-off?fecha_inicio=2026-05-01&fecha_fin=2026-05-31');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'X-API-KEY: afer_tk_TU_TOKEN',
    'X-API-SECRET: afer_sk_TU_SECRET',
]);

$respuesta = json_decode(curl_exec($ch), true);
curl_close($ch);
const respuesta = await fetch('https://api.afer.pro/api/v1/time-off?fecha_inicio=2026-05-01&fecha_fin=2026-05-31', {
  method: 'GET',
  headers: {
    'X-API-KEY': 'afer_tk_TU_TOKEN',
    'X-API-SECRET': 'afer_sk_TU_SECRET'
  }
});

const resultado = await respuesta.json();

Respuesta

200 · application/json 
{
    "errorCode": 200,
    "errorMsg": "",
    "data": {
        "periodo": {
            "desde": "2026-05-01",
            "hasta": "2026-05-31"
        },
        "total_ausencias": 1,
        "ausencias": [
            {
                "ausenciaId": "aUs31…",
                "empleado": {
                    "empleadoId": "eMp001…",
                    "nombre": "Ana",
                    "apellidos": "Pons Ferrer"
                },
                "titulo": "Vacaciones primavera",
                "tipo": "vacaciones",
                "tipo_titulo": "Vacaciones",
                "fecha_inicio": "2026-04-28",
                "fecha_fin": "2026-05-04",
                "dias_en_periodo": 4,
                "porcentaje_imputable": 100,
                "autorizada": true,
                "rechazada": false
            }
        ]
    }
}
Notas