API de plazos

API de plazos procesales: el vencimiento en días hábiles

Indica el día de partida y la regla —por ejemplo, el recurso de casación civil— y recibe la fecha límite contando días hábiles con el calendario que corresponde, con la traza paso a paso. Si falta el calendario de un año, te lo dice: un año sin datos no es un año sin festivos.

Estado del acceso

El acceso está abierto

Crea tu cuenta de desarrollador, confirma el correo y activa el segundo factor (obligatorio) para crear tu clave. Biblioteca, calculadoras y plazos no gastan saldo; empresas y asistente tienen 100 consultas de prueba, sin tarjeta.

El acceso será para empresas de cualquier país, previa verificación.

Para quién es

  • Software de gestión de despachos que quiere calcular y recordar vencimientos sin mantener los calendarios.
  • Agendas, recordatorios y herramientas de procuradores y graduados sociales.
  • Equipos que construyen sus propios flujos de trabajo para abogados.

Qué puedes hacer

Reglas por orden

GET /v1/dev/plazos/reglas lista las reglas de los cuatro órdenes (civil, penal, social y contencioso), incluidas las que todavía no están verificadas contra el texto consolidado, con lo que les falta: saber que no lo sabemos también es información.

El vencimiento, con su traza

POST /v1/dev/plazos/vencimiento suma la duración de la regla al día de partida con el calendario que corresponda y devuelve la fecha límite, el fundamento y los avisos.

Calendarios oficiales

Los festivos oficiales cargados, con su fuente, y los municipios con calendario local, para aplicar los de la sede del órgano.

Sin valores por defecto

Si falta el dato que decide el calendario (409) la respuesta dice cuál; si la regla no existe en ese orden, 404.

Las operaciones

  • GET/plazos/reglas

    Reglas de cómputo declaradas Detalle

    Gratis
  • GET/plazos/calendarios-oficiales

    Festivos oficiales cargados, con su fuente Detalle

    Gratis
  • GET/plazos/municipios

    Buscar el municipio de la sede del órgano Detalle

    Gratis
  • POST/plazos/vencimiento

    Calcular el vencimiento de un plazo Detalle

    Gratis

Ejemplos de petición y respuesta

Los ejemplos usan tu clave desde la variable de entorno JURILIA_API_KEY.

Las reglas de un orden

Cada regla con su clave, su unidad, su duración, su fundamento y si está verificada.

curl

curl "https://api.jurilia.com/v1/dev/plazos/reglas?orden=civil" \
  -H "Authorization: Bearer $JURILIA_API_KEY"

Python

import os
import requests

r = requests.get(
    "https://api.jurilia.com/v1/dev/plazos/reglas",
    headers={"Authorization": f"Bearer {os.environ['JURILIA_API_KEY']}"},
    params={"orden":"civil"},
    timeout=30,
)
r.raise_for_status()
print(r.json())

JavaScript

const url = new URL("https://api.jurilia.com/v1/dev/plazos/reglas");
url.search = new URLSearchParams({"orden":"civil"});
const r = await fetch(url, {
  headers: { Authorization: `Bearer ${process.env.JURILIA_API_KEY}` },
});
if (!r.ok) throw new Error(`HTTP ${r.status}`);
console.log(await r.json());

Respuesta (la forma; los valores son de ejemplo)

{
  "reglas": [
    { "orden": "civil", "tipo": "civil.casacion", "etiqueta": "Recurso de casación",
      "regimen": "procesal", "unidad": "dias_habiles", "duracion": 20,
      "fundamento": ["art. 479.1 LEC"], "verificado": true }
  ],
  "modalidadesSociales": ["…"]
}

Los valores son ilustrativos para que veas la forma exacta de la respuesta, no datos de una consulta real.

Calcular un vencimiento

La clave de la regla sale de /plazos/reglas; añade sedeDelOrgano para aplicar los festivos oficiales de la sede.

curl

curl -X POST https://api.jurilia.com/v1/dev/plazos/vencimiento \
  -H "Authorization: Bearer $JURILIA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"orden":"civil","tipo":"civil.casacion","diesAQuo":"2026-03-02"}'

Python

import os
import requests

r = requests.post(
    "https://api.jurilia.com/v1/dev/plazos/vencimiento",
    headers={"Authorization": f"Bearer {os.environ['JURILIA_API_KEY']}"},
    json={"orden":"civil","tipo":"civil.casacion","diesAQuo":"2026-03-02"},
    timeout=30,
)
r.raise_for_status()
print(r.json())

JavaScript

const r = await fetch("https://api.jurilia.com/v1/dev/plazos/vencimiento", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.JURILIA_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({"orden":"civil","tipo":"civil.casacion","diesAQuo":"2026-03-02"}),
});
if (!r.ok) throw new Error(`HTTP ${r.status}`);
console.log(await r.json());

Respuesta (la forma; los valores son de ejemplo)

{
  "fechaLimite": "2026-03-30",
  "fechaLimiteGracia": null,
  "traza": [
    "Dies a quo: 2026-03-02 (el plazo empieza a correr el día siguiente).",
    "Régimen: procesal. Duración: 20 dias_habiles.",
    "Suma de 20 días hábiles con el calendario aplicable: 2026-03-30."
  ],
  "fundamento": ["art. 479.1 LEC"],
  "calendario": {
    "nombre": "Procesal, régimen general",
    "fundamento": ["art. 130.2 LEC", "art. 183 LOPJ"],
    "avisos": ["Agosto entero y del 24 de diciembre al 6 de enero son inhábiles (LO 14/2022)."],
    "festivosOficiales": []
  }
}

Los valores son ilustrativos para que veas la forma exacta de la respuesta, no datos de una consulta real.

Por qué fiarse de lo que devuelve

Fechas civiles, no instantes

El cómputo trabaja con fechas civiles (AAAA-MM-DD) y no con zonas horarias: el cambio de hora no puede romper un plazo.

Avisa cuando no sabe

Si falta el calendario de un año o la regla no está verificada, lo dice en avisos o responde 409.

Traza y fundamento

La respuesta cuenta cómo se ha contado y en qué artículos se apoya.

Gratis

Plazos y calendarios no gastan saldo ni prueba.

Límites y lo que no hace

  • Es una ayuda de cálculo: el abogado comprueba el cómputo antes de fiarse de una fecha límite.
  • Sólo hay calendario de los años cargados: la respuesta avisa cuando falta el de un año.
  • Las reglas no verificadas contra el BOE no calculan (409): se declaran con lo que les falta.
  • 120 llamadas por minuto por clave.

Precio

Gratis. Pide tu clave y respeta el límite de 120 llamadas por minuto, pero no consume saldo ni la prueba.

Autenticación y errores

Cada llamada lleva la clave de tu cuenta de desarrollador en la cabecera Authorization: Bearer iuris_sk_…. La dirección base es https://api.jurilia.com. Hay un límite de 120 llamadas por minuto por clave, con las cabeceras X-RateLimit-Limit, X-RateLimit-Remaining y X-RateLimit-Reset en cada respuesta. Una clave puede llevar una lista blanca de IP o redes (CIDR).

Los fallos llegan en JSON con un código estable: 401 (clave ausente o inválida), 402 (sin saldo: no se sirve ni se cobra), 403 (IP no permitida), 409 (falta un dato que decide el cálculo: no se cobra) y 429 (demasiadas llamadas seguidas).

Preguntas frecuentes

¿Hay una API para calcular plazos en días hábiles?
Sí: POST /v1/dev/plazos/vencimiento suma la duración de una regla al día de partida con el calendario que corresponde y devuelve la fecha límite con su traza.
¿Qué calendarios usa?
Los festivos oficiales cargados, con su fuente (GET /v1/dev/plazos/calendarios-oficiales). Si se indica la sede del órgano, aplica los de esa sede; si falta el calendario de un año, lo avisa.
¿Qué reglas hay?
GET /v1/dev/plazos/reglas las lista por orden jurisdiccional, con su duración, su fundamento y si están verificadas.
¿Cuánto cuesta?
Nada: los plazos y los calendarios son gratis. Sólo necesitas tu clave.