Deadlines

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

Operations marked /v1 authenticate with an agent token; the rest, with a panel session. How both work is in Authentication

`closureImpact`

GET/_x/query/closure-impact

Firm memberPermission: deadline:write

closureImpact

Parameters of closureImpact
Name	In	Type	Required
`courtId`	Query	`string`	No
`endsOn`	Query	`string`	Yes
`startsOn`	Query	`string`	Yes
`_first`	Query	`integer 1–500`page size; present, the response is the page envelope rather than the bare rows (1 to 500)	No
`_after`	Query	`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();

Example response

200

[
  null
]

Errors

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

Firm memberPermission: deadline:read

listClosureCourts

Parameters of listClosureCourts
Name	In	Type	Required
`limit`	Query	`integer 1–500`	No
`orgId`	Query	`string (uuid)`	Yes
`_first`	Query	`integer 1–500`page size; present, the response is the page envelope rather than the bare rows (1 to 500)	No
`_after`	Query	`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();

Example response

200

[
  null
]

Errors

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

Firm memberPermission: deadline:read/v1 · bearer tokenMCP tool: listCourtClosures

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

Parameters of listCourtClosures
Name	In	Type	Required
`limit`	Query	`integer 1–500`	No
`orgId`	Query	`string (uuid)`	Yes
`_first`	Query	`integer 1–500`page size; present, the response is the page envelope rather than the bare rows (1 to 500)	No
`_after`	Query	`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();

Example response

200

[
  null
]

Errors

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

Firm memberPermission: deadline:read/v1 · bearer tokenMCP tool: listDeadlines

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

Parameters of listDeadlines
Name	In	Type	Required
`after`	Query	`string (uuid)`	No
`caseId`	Query	`string (uuid)`	No
`cursor`	Query	`string (uuid)`	No
`from`	Query	`string`	No
`limit`	Query	`integer 1–500`	No
`notificationId`	Query	`string (uuid)`	No
`orgId`	Query	`string (uuid)`	Yes
`status`	Query	`"computed" \| "blocked_bounce"`	No
`to`	Query	`string`	No
`_first`	Query	`integer 1–500`page size; present, the response is the page envelope rather than the bare rows (1 to 500)	No
`_after`	Query	`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();

Example response

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
  }
]

Errors

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

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

Parameters of upcomingDeadlines
Name	In	Type	Required
`limit`	Query	`integer 1–100`	No
`orgId`	Query	`string (uuid)`	Yes
`_first`	Query	`integer 1–500`page size; present, the response is the page envelope rather than the bare rows (1 to 500)	No
`_after`	Query	`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();

Example response

200

[
  null
]

Errors

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

Firm memberPermission: deadline:write

listGlobalClosures

Parameters of listGlobalClosures
Name	In	Type	Required
`limit`	Body	`integer 1–500`	No
`year`	Body	`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();

Example response

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>"
    }
  ]
}

Errors

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

Firm memberPermission: deadline:write

setCourtClosure

Parameters of setCourtClosure
Name	In	Type	Required
`code`	Body	`string 1–64`	No
`courtId`	Body	`string`	No
`endsOn`	Body	`string`	Yes
`global`	Body	`boolean`	No
`kind`	Body	`"cierre_extraordinario" \| "vacancia_colectiva" \| "semana_santa"`	No
`reason`	Body	`string 0–500`	No
`sourceUrl`	Body	`string 0–2048`	No
`startsOn`	Body	`string`	Yes

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();

Example response

200

{
  "courtId": "<courtId>",
  "endsOn": "<endsOn>",
  "global": true,
  "id": "<id>",
  "kind": "<kind>",
  "recomputing": -9007199254740991,
  "startsOn": "<startsOn>"
}

Errors

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

Firm memberPermission: deadline:write

withdrawGlobalClosure

Parameters of withdrawGlobalClosure
Name	In	Type	Required
`closureId`	Body	`string (uuid)`	Yes
`code`	Body	`string 1–64`	No
`reason`	Body	`string 0–500`	Yes

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();

Example response

200

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

Errors

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

Preferences

Language

Appearance

Deadlines

`closureImpact`

`listClosureCourts`

`listCourtClosures`

`listDeadlines`

`upcomingDeadlines`

`listGlobalClosures`

`setCourtClosure`

`withdrawGlobalClosure`