Plazos

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

Las operaciones marcadas /v1 se autentican con un token de agente; las demás, con una sesión del panel. Cómo funcionan ambas está en Autenticación

`closureImpact`

GET/_x/query/closure-impact

Miembro de la firmaPermiso: deadline:write

closureImpact

Parámetros de closureImpact
Nombre	Dónde	Tipo	Obligatorio
`courtId`	Consulta	`string`	No
`endsOn`	Consulta	`string`	Sí
`startsOn`	Consulta	`string`	Sí
`_first`	Consulta	`integer 1–500`page size; present, the response is the page envelope rather than the bare rows (1 to 500)	No
`_after`	Consulta	`string`the nextCursor a previous page answered; needs _first	No

curl

curl 'https://www.notificado.co/_x/query/closure-impact?endsOn=<endsOn>&startsOn=<startsOn>' \
  -b cookies.txt

TypeScript

const response = await fetch('https://www.notificado.co/_x/query/closure-impact?endsOn=<endsOn>&startsOn=<startsOn>', {
  headers: { cookie: sessionCookie },
});
const result = await response.json();

Ejemplo de respuesta

200

[
  null
]

Errores

400 X_INPUT_INVALID or X_CURSOR_INVALID
401 X_UNAUTHENTICATED — no credential, or one that did not resolve
403 policy denied
429 X_RATE_LIMITED — retry after Retry-After seconds

`listClosureCourts`

GET/_x/query/list-closure-courts

Miembro de la firmaPermiso: deadline:read

listClosureCourts

Parámetros de listClosureCourts
Nombre	Dónde	Tipo	Obligatorio
`limit`	Consulta	`integer 1–500`	No
`orgId`	Consulta	`string (uuid)`	Sí
`_first`	Consulta	`integer 1–500`page size; present, the response is the page envelope rather than the bare rows (1 to 500)	No
`_after`	Consulta	`string`the nextCursor a previous page answered; needs _first	No

curl

curl 'https://www.notificado.co/_x/query/list-closure-courts?orgId=<orgId>' \
  -b cookies.txt

TypeScript

const response = await fetch('https://www.notificado.co/_x/query/list-closure-courts?orgId=<orgId>', {
  headers: { cookie: sessionCookie },
});
const result = await response.json();

Ejemplo de respuesta

200

[
  null
]

Errores

400 X_INPUT_INVALID or X_CURSOR_INVALID
401 X_UNAUTHENTICATED — no credential, or one that did not resolve
403 policy denied
429 X_RATE_LIMITED — retry after Retry-After seconds

`listCourtClosures`

GET/v1/list-court-closures

Miembro de la firmaPermiso: deadline:read/v1 · token BearerHerramienta MCP: listCourtClosures

The firm's recorded court closures that terms skip. Recording one is a person's act in the panel.

Parámetros de listCourtClosures
Nombre	Dónde	Tipo	Obligatorio
`limit`	Consulta	`integer 1–500`	No
`orgId`	Consulta	`string (uuid)`	Sí
`_first`	Consulta	`integer 1–500`page size; present, the response is the page envelope rather than the bare rows (1 to 500)	No
`_after`	Consulta	`string`the nextCursor a previous page answered; needs _first	No

curl

curl 'https://www.notificado.co/v1/list-court-closures?orgId=<orgId>' \
  -H "authorization: Bearer $NOTIFICADO_TOKEN"

TypeScript

const response = await fetch('https://www.notificado.co/v1/list-court-closures?orgId=<orgId>', {
  headers: { authorization: `Bearer ${token}` },
});
const result = await response.json();

Ejemplo de respuesta

200

[
  null
]

Errores

400 X_INPUT_INVALID or X_CURSOR_INVALID
401 X_UNAUTHENTICATED — no credential, or one that did not resolve
403 policy denied
429 X_RATE_LIMITED — retry after Retry-After seconds

`listDeadlines`

GET/v1/list-deadlines

Miembro de la firmaPermiso: deadline:read/v1 · token BearerHerramienta MCP: listDeadlines

Computed terms per recipient (Bogotá dates). An ESTIMATE: the judge decides. blocked_bounce = not notified.

Parámetros de listDeadlines
Nombre	Dónde	Tipo	Obligatorio
`after`	Consulta	`string (uuid)`	No
`caseId`	Consulta	`string (uuid)`	No
`cursor`	Consulta	`string (uuid)`	No
`from`	Consulta	`string`	No
`limit`	Consulta	`integer 1–500`	No
`notificationId`	Consulta	`string (uuid)`	No
`orgId`	Consulta	`string (uuid)`	Sí
`status`	Consulta	`"computed" \| "blocked_bounce"`	No
`to`	Consulta	`string`	No
`_first`	Consulta	`integer 1–500`page size; present, the response is the page envelope rather than the bare rows (1 to 500)	No
`_after`	Consulta	`string`the nextCursor a previous page answered; needs _first	No

curl

curl 'https://www.notificado.co/v1/list-deadlines?orgId=<orgId>' \
  -H "authorization: Bearer $NOTIFICADO_TOKEN"

TypeScript

const response = await fetch('https://www.notificado.co/v1/list-deadlines?orgId=<orgId>', {
  headers: { authorization: `Bearer ${token}` },
});
const result = await response.json();

Ejemplo de respuesta

200

[
  {
    "calendarVersion": "<calendarVersion>",
    "caseId": "<caseId>",
    "computedAt": "<computedAt>",
    "conservative": {
      "sendWindowVersion": "<sendWindowVersion>",
      "surtidaAt": "<surtidaAt>",
      "surtidaOn": "<surtidaOn>",
      "termEndsAt": "<termEndsAt>",
      "termEndsOn": "<termEndsOn>",
      "termStartsAt": "<termStartsAt>",
      "termStartsOn": "<termStartsOn>"
    },
    "disclaimerKey": "<disclaimerKey>",
    "id": "<id>",
    "inputsSha256": "<inputsSha256>",
    "notificationId": "<notificationId>",
    "orgId": "<orgId>",
    "radicado": "<radicado>",
    "recipientId": "<recipientId>",
    "recipientName": "<recipientName>",
    "sentAt": "<sentAt>",
    "status": "computed",
    "surtidaAt": "<surtidaAt>",
    "surtidaOn": "<surtidaOn>",
    "termDays": 1,
    "termDaysAssumed": true,
    "termEndsAt": "<termEndsAt>",
    "termEndsOn": "<termEndsOn>",
    "termStartsAt": "<termStartsAt>",
    "termStartsOn": "<termStartsOn>",
    "vacanciaCountsForSurtida": true
  }
]

Errores

400 X_INPUT_INVALID or X_CURSOR_INVALID
401 X_UNAUTHENTICATED — no credential, or one that did not resolve
403 policy denied
429 X_RATE_LIMITED — retry after Retry-After seconds

`upcomingDeadlines`

GET/_x/query/upcoming-deadlines

Miembro de la firmaPermiso: deadline:readHerramienta MCP: upcomingDeadlines

The caller's firm's next vencimientos (Ley 2213 art. 8), from today in America/Bogota on, soonest first — ONE row per case and recipient address (the soonest; laterTerms counts the other upcoming terms of the same pair). Each row carries notificationId, caseId, radicado, recipientName and surtidaOn / termStartsOn / termEndsOn (YYYY-MM-DD, Bogotá). For every term use listDeadlines. The dates are an ESTIMATE — always tell the user the judge decides. Read-only.

Parámetros de upcomingDeadlines
Nombre	Dónde	Tipo	Obligatorio
`limit`	Consulta	`integer 1–100`	No
`orgId`	Consulta	`string (uuid)`	Sí
`_first`	Consulta	`integer 1–500`page size; present, the response is the page envelope rather than the bare rows (1 to 500)	No
`_after`	Consulta	`string`the nextCursor a previous page answered; needs _first	No

curl

curl 'https://www.notificado.co/_x/query/upcoming-deadlines?orgId=<orgId>' \
  -b cookies.txt

TypeScript

const response = await fetch('https://www.notificado.co/_x/query/upcoming-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
401 X_UNAUTHENTICATED — no credential, or one that did not resolve
403 policy denied
429 X_RATE_LIMITED — retry after Retry-After seconds

`listGlobalClosures`

POST/api/list-global-closures

Miembro de la firmaPermiso: deadline:write

listGlobalClosures

Parámetros de listGlobalClosures
Nombre	Dónde	Tipo	Obligatorio
`limit`	Cuerpo	`integer 1–500`	No
`year`	Cuerpo	`integer 2000–2100`	No

curl

curl -X POST 'https://www.notificado.co/api/list-global-closures' \
  -b cookies.txt \
  -H 'origin: https://www.notificado.co' \
  -H 'content-type: application/json' \
  -d '{}'

TypeScript

const response = await fetch('https://www.notificado.co/api/list-global-closures', {
  method: 'POST',
  headers: { 'content-type': 'application/json', origin: 'https://www.notificado.co', cookie: sessionCookie },
  body: JSON.stringify({}),
});
const result = await response.json();

Ejemplo de respuesta

200

{
  "rows": [
    {
      "courtId": "<courtId>",
      "createdAt": "2026-09-25T15:00:00Z",
      "createdBy": "<createdBy>",
      "createdByEmail": "<createdByEmail>",
      "endsOn": "<endsOn>",
      "id": "<id>",
      "kind": "<kind>",
      "reason": "<reason>",
      "seeded": true,
      "sourceUrl": "<sourceUrl>",
      "startsOn": "<startsOn>",
      "withdrawReason": "<withdrawReason>",
      "withdrawnAt": "2026-09-25T15:00:00Z",
      "withdrawnBy": "<withdrawnBy>",
      "withdrawnByEmail": "<withdrawnByEmail>"
    }
  ]
}

Errores

400 X_INPUT_INVALID
401 X_UNAUTHENTICATED — no credential, or one that did not resolve
403 policy denied
422 X_BODY_INVALID
429 X_RATE_LIMITED — retry after Retry-After seconds

`setCourtClosure`

POST/api/set-court-closure

Miembro de la firmaPermiso: deadline:write

setCourtClosure

Parámetros de setCourtClosure
Nombre	Dónde	Tipo	Obligatorio
`code`	Cuerpo	`string 1–64`	No
`courtId`	Cuerpo	`string`	No
`endsOn`	Cuerpo	`string`	Sí
`global`	Cuerpo	`boolean`	No
`kind`	Cuerpo	`"cierre_extraordinario" \| "vacancia_colectiva" \| "semana_santa"`	No
`reason`	Cuerpo	`string 0–500`	No
`sourceUrl`	Cuerpo	`string 0–2048`	No
`startsOn`	Cuerpo	`string`	Sí

curl

curl -X POST 'https://www.notificado.co/api/set-court-closure' \
  -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/set-court-closure', {
  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
401 X_UNAUTHENTICATED — no credential, or one that did not resolve
403 policy denied
422 X_BODY_INVALID
429 X_RATE_LIMITED — retry after Retry-After seconds

`withdrawGlobalClosure`

POST/api/withdraw-global-closure

Miembro de la firmaPermiso: deadline:write

withdrawGlobalClosure

Parámetros de withdrawGlobalClosure
Nombre	Dónde	Tipo	Obligatorio
`closureId`	Cuerpo	`string (uuid)`	Sí
`code`	Cuerpo	`string 1–64`	No
`reason`	Cuerpo	`string 0–500`	Sí

curl

curl -X POST 'https://www.notificado.co/api/withdraw-global-closure' \
  -b cookies.txt \
  -H 'origin: https://www.notificado.co' \
  -H 'content-type: application/json' \
  -d '{"closureId":"<closureId>","reason":"<reason>"}'

TypeScript

const response = await fetch('https://www.notificado.co/api/withdraw-global-closure', {
  method: 'POST',
  headers: { 'content-type': 'application/json', origin: 'https://www.notificado.co', cookie: sessionCookie },
  body: JSON.stringify({
    "closureId": "<closureId>",
    "reason": "<reason>"
  }),
});
const result = await response.json();

Ejemplo de respuesta

200

{
  "courtId": "<courtId>",
  "endsOn": "<endsOn>",
  "id": "<id>",
  "kind": "<kind>",
  "recomputing": -9007199254740991,
  "startsOn": "<startsOn>",
  "withdrawnAt": "2026-09-25T15:00:00Z"
}

Errores

400 X_INPUT_INVALID
401 X_UNAUTHENTICATED — no credential, or one that did not resolve
403 policy denied
422 X_BODY_INVALID
429 X_RATE_LIMITED — retry after Retry-After seconds

Preferencias

Idioma

Apariencia

Plazos

`closureImpact`

`listClosureCourts`

`listCourtClosures`

`listDeadlines`

`upcomingDeadlines`

`listGlobalClosures`

`setCourtClosure`

`withdrawGlobalClosure`