Recipients whose notification could NOT be delivered (status bounced: the recipient's mail server refused it for good; status failed: our mail transport refused to send it) or who marked it as unwanted (complained), newest first, with the case radicado. Without notificationId: only those not yet re-issued to another address. With notificationId: that notification's failed recipients, `switched: true` when already re-issued. Next steps for bounced or failed: verify the address, re-issue to another sworn address in the panel (switchChannel), or notify by physical means. Read-only.
Parameters of bounceAlerts
Name
In
Type
Required
notificationId
Query
string (uuid)
No
orgId
Query
string (uuid)
Yes
_first
Query
integer 1–10000page size; present, the response is the page envelope rather than the bare rows (1 to 10000)
No
_after
Query
stringthe endCursor a previous page answered; needs _first
List one case’s notifications, newest first (up to 200): id, case, status (draft | freezing | frozen | sending | sent | failed), subject, the frozen .eml SHA-256 and UTC timestamps. Read-only.
Parameters of caseNotifications
Name
In
Type
Required
caseId
Query
string (uuid)
Yes
limit
Query
integer 1–200
No
orgId
Query
string (uuid)
Yes
_first
Query
integer 1–10000page size; present, the response is the page envelope rather than the bare rows (1 to 10000)
No
_after
Query
stringthe endCursor a previous page answered; needs _first
Whether a memorial can be generated now for one notification in your organization. One row: ready, and when not ready the reason — "bounce" (a recipient bounced: NOT notified; re-issue to another address first), "not-delivered" (a recipient server has not accepted the message yet), "constancia-pending" or "term-pending" (still being produced, retry in a minute) — with the X_ code createMemorial would refuse with. Read-only.
Parameters of memorialReadiness
Name
In
Type
Required
notificationId
Query
string (uuid)
Yes
orgId
Query
string (uuid)
Yes
_first
Query
integer 1–10000page size; present, the response is the page envelope rather than the bare rows (1 to 10000)
No
_after
Query
stringthe endCursor a previous page answered; needs _first
One notification by id: status, recipients with delivery status and how each address was obtained, attachments with SHA-256, and the evidence timeline (message.frozen, transport.sent, mail.delivery, bounces, downloads, acknowledgements) in chain order with UTC times. Opens are marked indicio (never proof of reading). Read-only.
Parameters of notificationDetail
Name
In
Type
Required
id
Query
string (uuid)
Yes
orgId
Query
string (uuid)
Yes
_first
Query
integer 1–10000page size; present, the response is the page envelope rather than the bare rows (1 to 10000)
No
_after
Query
stringthe endCursor a previous page answered; needs _first
List the org’s notifications, newest first: id, case, status (draft | freezing | frozen | sending | sent | failed), subject, the frozen .eml SHA-256 and UTC timestamps. For the next page pass cursor = "<createdAt>_<id>" of the last row you got. Read-only.
Parameters of notificationList
Name
In
Type
Required
cursor
Query
string 1–64
No
limit
Query
integer 1–200
No
orgId
Query
string (uuid)
Yes
_first
Query
integer 1–10000page size; present, the response is the page envelope rather than the bare rows (1 to 10000)
No
_after
Query
stringthe endCursor a previous page answered; needs _first
The memorials generated for one notification in your organization, newest first: id, createdAt, and the SHA-256 and size of the DOCX and the PDF, plus factsSha256 (the hash of the facts the memorial cites). Poll it after createMemorial until the new memorialId appears (seconds), then fetch the files with downloadMemorial. Read-only.
Parameters of notificationMemorials
Name
In
Type
Required
limit
Query
integer 1–200
No
notificationId
Query
string (uuid)
Yes
orgId
Query
string (uuid)
Yes
_first
Query
integer 1–10000page size; present, the response is the page envelope rather than the bare rows (1 to 10000)
No
_after
Query
stringthe endCursor a previous page answered; needs _first
Generates the memorial (DOCX + PDF draft, in Spanish) that informs the juzgado that personal notification under art. 8 Ley 2213 de 2022 was practised for one notification in your organization: radicado, juzgado, parties, each recipient with sent/delivered/acknowledged times in America/Bogota, the sworn forma de obtención, the constancia verify code and URL, the computed term dates with their disclaimer and inputsSha256, and the annexes with SHA-256. Returns the memorialId and the render job handle; download the files with downloadMemorial once notificationMemorials lists it (seconds). It is a DRAFT marked [LAWYER REVIEW]: a lawyer must review, sign and file it — nothing is sent to the court. Refused with X_MEMORIAL_BLOCKED_BOUNCE while any recipient bounced, X_MEMORIAL_NOT_DELIVERED before delivery, X_MEMORIAL_CONSTANCIA_PENDING / X_MEMORIAL_TERM_PENDING while those are still being produced.
Returns the bytes (base64, with filename, content type and SHA-256) of one generated memorial in your organization, as "docx" (editable, for the lawyer to review and sign) or "pdf" (with the constancia verification QR). The SHA-256 is re-checked against the memorial record before the bytes are served, and every download is recorded in the audit log. Fails X_MEMORIAL_NOT_FOUND for an unknown id or one whose render job has not finished.
REQUEST the send of a draft notification — REQUIRES HUMAN CONFIRMATION. Over MCP this never sends: it checks the draft is ready (recipients sworn by the lawyer in the panel, at least one attachment, under 20 MB) and returns { status: "awaiting_confirmation", confirmUrl, expiresAt }; hand confirmUrl to the lawyer, who confirms in the panel within 24 hours — only then is one credit per recipient consumed and the exact message frozen, timestamped and emailed. Call it once, with confirm: true, only after showing the lawyer the recipients and attachments. Do NOT call it to test, and do not retry after awaiting_confirmation. Requires an approved lawyer KYC (X_KYC_REQUIRED otherwise). If your token belongs to a paralegal it returns { status: "awaiting_approval", approvalUrl } instead: a lawyer of the firm approves or rejects it in the panel (X_SEND_APPROVALS_OFF when the firm has not turned approvals on).