> ## Documentation Index > Fetch the complete documentation index at: https://docs.lerian.studio/llms.txt > Use this file to discover all available pages before exploring further. # List operational alerts > The operational alerts, filtered by type and (by default) active only, keyset-paged newest first. A RECALCULATION alert carries its correlated cycle's active recálculo round complement window, read verbatim from ot_recalculations — never netted, summed, or recomputed (D-4). A connection-level alert (e.g. RELAY_DOWN) carries no cycle and no window. activeOnly=false includes deactivated alerts (history). Read-only — cross-operator acknowledgement is handled by br-desk, not this rail. ## OpenAPI ````yaml pt/openapi/v3-current/siloc.yaml get /api/v1/siloc/alerts openapi: 3.1.0 info: description: >- Interface OpenAPI 3.1 do Lerian SILOC, o trilho do lado do participante que conecta a instituição à liquidação interbancária diferida por compensação SILOC da Núclea. Abrange as capacidades de cobertura de liquidação, o registro de participantes e seu status operacional, o ciclo de vida dos certificados regulados, o relay de mensagens do domínio de cartões e seu status, o reenvio administrativo de falhas de relay estacionadas, os ciclos OT e as rodadas de recálculo, as instruções de liquidação, a ingestão de ROC, os alertas operacionais, as mudanças de agenda de contingência, a leitura do calendário de dias úteis e a trilha de auditoria. title: Lerian SILOC API version: 1.0.0 servers: - url: http://localhost:9820 security: [] paths: /api/v1/siloc/alerts: get: tags: - Alerts summary: List operational alerts description: >- The operational alerts, filtered by type and (by default) active only, keyset-paged newest first. A RECALCULATION alert carries its correlated cycle's active recálculo round complement window, read verbatim from ot_recalculations — never netted, summed, or recomputed (D-4). A connection-level alert (e.g. RELAY_DOWN) carries no cycle and no window. activeOnly=false includes deactivated alerts (history). Read-only — cross-operator acknowledgement is handled by br-desk, not this rail. operationId: listAlerts parameters: - description: Filter by alert type. explode: false in: query name: type schema: description: Filter by alert type. enum: - WINDOW_CLOSING - RECALCULATION - RELAY_DOWN - CERTIFICATE_EXPIRY - CONNECTION_DOWN - SCHEDULE_CHANGE type: string - description: >- When true (default), returns only active (unresolved) alerts; false includes deactivated alerts (history). explode: false in: query name: activeOnly schema: default: true description: >- When true (default), returns only active (unresolved) alerts; false includes deactivated alerts (history). type: boolean - description: Opaque pagination cursor. explode: false in: query name: cursor schema: description: Opaque pagination cursor. type: string - description: Page size (default 50, max 200). explode: false in: query name: limit schema: default: 50 description: Page size (default 50, max 200). format: int64 maximum: 200 minimum: 1 type: integer responses: '200': content: application/json: schema: $ref: '#/components/schemas/AlertListResponse' description: OK default: content: application/problem+json: schema: $ref: '#/components/schemas/Detail' description: Error security: - BearerAuth: [] components: schemas: AlertListResponse: additionalProperties: false properties: hasMore: description: Whether more alerts exist beyond this page. type: boolean items: description: The page of alerts (never null; empty when nothing matches). items: $ref: '#/components/schemas/AlertResponse' type: - array - 'null' nextCursor: description: Opaque cursor for the next page; omitted when the feed is exhausted. type: string required: - items - hasMore type: object Detail: additionalProperties: false properties: code: description: >- Stable, machine-readable domain error code scoped to the emitting service (format: -NNNN). examples: - ERR-0001 type: string detail: description: >- A human-readable explanation specific to this occurrence of the problem. examples: - Property foo is required but is missing. type: string errors: description: Optional list of individual error details items: $ref: '#/components/schemas/ErrorDetail' type: - array - 'null' instance: description: >- A URI reference that identifies the specific occurrence of the problem. examples: - https://example.com/error-log/abc123 format: uri type: string status: description: HTTP status code examples: - 400 format: int64 type: integer title: description: >- A short, human-readable summary of the problem type. This value should not change between occurrences of the error. examples: - Bad Request type: string type: default: about:blank description: A URI reference to human-readable documentation for the error. examples: - https://example.com/errors/example format: uri type: string type: object AlertResponse: additionalProperties: false properties: active: description: >- Whether the alert is active. false appears only when activeOnly=false surfaces deactivated (history) alerts. type: boolean complementWindowClosesAt: description: >- For a RECALCULATION alert whose cycle holds an active recálculo round, the round's complement/deposit deadline, projected verbatim from ot_recalculations.complement_window_closes_at; omitted otherwise. format: date-time type: string cycleId: description: >- Correlated cycle id; omitted for a connection-level alert (e.g. RELAY_DOWN). format: uuid type: string deadlineAt: description: >- Absolute deadline this alert tracks (e.g. a WINDOW_CLOSING deposit close or a CERTIFICATE_EXPIRY not-after), projected verbatim from alerts.deadline_at; omitted when the stored column is NULL. format: date-time type: string id: description: >- Alert id; the opaque key consumers address the alert by (br-desk acknowledgement) and correlate to the alert.{raised,cleared} facts. format: uuid type: string message: description: >- Operator-facing alert message; omitted when the stored message is empty. type: string raisedAt: description: Alert raise instant. format: date-time type: string type: description: Alert type. enum: - WINDOW_CLOSING - RECALCULATION - RELAY_DOWN - CERTIFICATE_EXPIRY - CONNECTION_DOWN - SCHEDULE_CHANGE type: string required: - id - type - raisedAt - active type: object ErrorDetail: additionalProperties: false properties: location: description: >- Where the error occurred, e.g. 'body.items[3].tags' or 'path.thing-id' type: string message: description: Error message text type: string value: description: The value at the given location type: object securitySchemes: BearerAuth: bearerFormat: JWT description: JWT bearer token issued by the identity provider. scheme: bearer type: http ````