Skip to content
Notificado
Menu
Create account

API reference

Deadlines

2 operations, each with its parameters, curl and TypeScript examples ready to copy, and its errors.

Every example assumes a signed-in session; how to get one is in Authentication

listDeadlines

GET/_x/query/list-deadlines

Firm memberPermission: deadline:readMCP tool: 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.

Parameters of listDeadlines
NameInTypeRequired
caseIdQuerystring (uuid)No
fromQuerystringNo
limitQueryinteger 1–500No
orgIdQuerystring (uuid)Yes
toQuerystringNo
_firstQueryinteger 1–10000page size; present, the response is the page envelope rather than the bare rows (1 to 10000)No
_afterQuerystringthe 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();
Example response
200
[
  null
]

Errors

  • 400 X_INPUT_INVALID or X_CURSOR_INVALID
  • 403 policy denied

setCourtClosure

POST/api/court-closures/set

Firm memberPermission: deadline:write

setCourtClosure

Parameters of setCourtClosure
NameInTypeRequired
courtIdBodystringNo
endsOnBodystringYes
globalBodybooleanNo
kindBody"cierre_extraordinario" | "vacancia_colectiva" | "semana_santa"No
sourceUrlBodystring (uri) ≤ 2048No
startsOnBodystringYes
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();
Example response
200
{
  "courtId": "<courtId>",
  "endsOn": "<endsOn>",
  "global": true,
  "id": "<id>",
  "kind": "<kind>",
  "recomputing": -9007199254740991,
  "startsOn": "<startsOn>"
}

Errors

  • 400 X_INPUT_INVALID
  • 403 policy denied
  • 422 X_BODY_INVALID