> ## 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 es/openapi/v3-current/siloc.yaml get /api/v1/siloc/alerts
openapi: 3.1.0
info:
  description: >-
    Interfaz OpenAPI 3.1 de Lerian SILOC, el riel del lado del participante que
    conecta la institución con la liquidación interbancaria diferida por neteo
    SILOC de Núclea. Cubre las capacidades de cobertura de liquidación, el
    registro de participantes y su estado operativo, el ciclo de vida de los
    certificados regulados, el relay de mensajes del dominio de tarjetas y su
    estado, el reenvío administrativo de fallos de relay estacionados, los
    ciclos OT y las rondas de recálculo, las instrucciones de liquidación, la
    ingestión de ROC, las alertas operacionales, los cambios de agenda de
    contingencia, la lectura del calendario de días útiles y la trilla de
    auditoría.
  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: <SERVICE>-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

````