Feriados

GET /api/quantis/v3/holidays/

Devuelve la lista de feriados bancarios y nacionales venezolanos para un año dado, con contexto sobre si hoy es feriado.


Método	`GET`
URL	`https://app.vzla.io/api/quantis/v3/holidays/`
Autenticación	`Authorization: Bearer qapi_...`

Parámetros de consulta

Parámetro	Tipo	Requerido	Descripción	Por defecto
`year`	integer	No	El año calendario a consultar, p. ej. `2025`	Año actual
`type`	string	No	Filtrar por tipo: `bancario` o `feriado`	Todos los tipos

Solicitud

# Todos los feriados de 2025
curl --request GET \
  --url 'https://app.vzla.io/api/quantis/v3/holidays/?year=2025' \
  --header 'Authorization: Bearer qapi_TU_CLAVE_AQUI'

# Solo feriados bancarios
curl --request GET \
  --url 'https://app.vzla.io/api/quantis/v3/holidays/?year=2025&type=bancario' \
  --header 'Authorization: Bearer qapi_TU_CLAVE_AQUI'

Respuesta

`data`

Un array plano de objetos de feriado.

Campo	Tipo	Descripción
`date`	string (fecha ISO 8601)	Fecha del feriado, p. ej. `"2025-01-01"`
`name`	string	Nombre del feriado
`type`	string	`"bancario"` o `"feriado"`
`notes`	string	Notas opcionales sobre este feriado

`meta`

Campo	Tipo	Descripción
`today`	object	Contexto sobre el día calendario actual

meta.today

Campo	Tipo	Descripción
`date`	string (fecha ISO 8601)	La fecha de hoy
`is_bank_holiday`	boolean	Si hoy es feriado bancario
`is_weekend`	boolean	Si hoy es sábado o domingo

meta.today siempre refleja el día actual, independientemente del year consultado.

Ejemplo de respuesta

{
  "data": [
    {
      "date": "2025-01-01",
      "name": "Año Nuevo",
      "type": "bancario",
      "notes": ""
    },
    {
      "date": "2025-05-12",
      "name": "Día del Trabajador",
      "type": "feriado",
      "notes": ""
    },
    {
      "date": "2025-06-03",
      "name": "Día de la Independencia",
      "type": "bancario",
      "notes": ""
    },
    {
      "date": "2025-11-04",
      "name": "Día de la Resistencia Indígena",
      "type": "bancario",
      "notes": ""
    },
    {
      "date": "2025-11-12",
      "name": "Día de la Raza",
      "type": "feriado",
      "notes": ""
    }
  ],
  "meta": {
    "today": {
      "date": "2026-05-06",
      "is_bank_holiday": false,
      "is_weekend": false
    }
  }
}

Códigos de estado HTTP

Código	Significado
`200 OK`	Éxito.
`400 Bad Request`	Parámetro `year` o `type` inválido.
`401 Unauthorized`	Clave ausente, inválida o revocada.
`405 Method Not Allowed`	Solo se admite GET.
`429 Too Many Requests`	Cuota mensual agotada (`quota_exceeded`) o límite de velocidad alcanzado (`throttled`). Ver Planes y límites.
`500 Internal Server Error`	Error del servidor. Reintenta después de un momento.

400: año inválido

{
  "error": {
    "code": "invalid_parameter",
    "message": "year must be a 4-digit integer",
    "details": {}
  }
}

400: tipo inválido

{
  "error": {
    "code": "invalid_parameter",
    "message": "type must be one of: bancario, feriado",
    "details": {}
  }
}

401: sin encabezado Authorization

{
  "error": {
    "code": "auth_missing",
    "message": "Authentication credentials were not provided"
  }
}

401: clave inválida

{
  "error": {
    "code": "auth_token_unknown",
    "message": "Invalid token format"
  }
}

429: cuota mensual agotada

{
  "error": {
    "code": "quota_exceeded",
    "message": "Monthly quota exceeded. It resets on the 1st of next month."
  }
}

429: límite de velocidad alcanzado

{
  "error": {
    "code": "throttled",
    "message": "Rate limit exceeded",
    "details": {
      "retry_after": 1
    }
  }
}

Documentación completa en texto plano para herramientas de IA (llms.txt)