Saltar al contenido
Notificado
Menú
Crear cuenta

Referencia de la API

Plazos

2 operaciones, cada una con sus parámetros, ejemplos en curl y TypeScript listos para copiar y sus errores.

Cada ejemplo supone una sesión iniciada; cómo obtenerla está en Autenticación

listDeadlines

GET/_x/query/list-deadlines

Miembro de la firmaPermiso: deadline:readHerramienta MCP: listDeadlines

The caller's firm's deadlines (términos) under Ley 2213 art. 8, one row per notification × recipient: surtidaOn (envío + 2 días hábiles), termStartsOn (next día hábil) and termEndsOn (vencimiento, after termDays días hábiles), all YYYY-MM-DD in America/Bogota, skipping weekends, festivos, vacancia judicial and court closures. status 'blocked_bounce' means the recipient bounced: NOT notified, no dates. Filter by caseId, and by vencimiento day with from/to (YYYY-MM-DD, inclusive). Soonest vencimiento first. The dates are an ESTIMATE — always tell the user the judge decides (disclaimerKey), and cite calendarVersion + inputsSha256 when quoting one. Read-only.

Parámetros de listDeadlines
NombreDóndeTipoObligatorio
caseIdConsultastring (uuid)No
fromConsultastringNo
limitConsultainteger 1–500No
orgIdConsultastring (uuid)Sí
toConsultastringNo
_firstConsultainteger 1–10000page size; present, the response is the page envelope rather than the bare rows (1 to 10000)No
_afterConsultastringthe endCursor a previous page answered; needs _firstNo
curl
curl 'https://www.notificado.co/_x/query/list-deadlines?orgId=<orgId>' \
  -b cookies.txt
TypeScript
const response = await fetch('https://www.notificado.co/_x/query/list-deadlines?orgId=<orgId>', {
  headers: { cookie: sessionCookie },
});
const result = await response.json();
Ejemplo de respuesta
200
[
  null
]

Errores

  • 400 X_INPUT_INVALID or X_CURSOR_INVALID
  • 403 policy denied

setCourtClosure

POST/api/court-closures/set

Miembro de la firmaPermiso: deadline:write

setCourtClosure

Parámetros de setCourtClosure
NombreDóndeTipoObligatorio
courtIdCuerpostringNo
endsOnCuerpostringSí
globalCuerpobooleanNo
kindCuerpo"cierre_extraordinario" | "vacancia_colectiva" | "semana_santa"No
sourceUrlCuerpostring (uri) ≤ 2048No
startsOnCuerpostringSí
curl
curl -X POST 'https://www.notificado.co/api/court-closures/set' \
  -b cookies.txt \
  -H 'origin: https://www.notificado.co' \
  -H 'content-type: application/json' \
  -d '{"endsOn":"<endsOn>","startsOn":"<startsOn>"}'
TypeScript
const response = await fetch('https://www.notificado.co/api/court-closures/set', {
  method: 'POST',
  headers: { 'content-type': 'application/json', origin: 'https://www.notificado.co', cookie: sessionCookie },
  body: JSON.stringify({
    "endsOn": "<endsOn>",
    "startsOn": "<startsOn>"
  }),
});
const result = await response.json();
Ejemplo de respuesta
200
{
  "courtId": "<courtId>",
  "endsOn": "<endsOn>",
  "global": true,
  "id": "<id>",
  "kind": "<kind>",
  "recomputing": -9007199254740991,
  "startsOn": "<startsOn>"
}

Errores

  • 400 X_INPUT_INVALID
  • 403 policy denied
  • 422 X_BODY_INVALID